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Preface 


Due to the spectacular growth of the use of personal microcomputers such as the 
Atari 400 and 800 models, more and more people are acquiring their own com¬ 
puters. These new users naturally want to make the most of the capabilities of 
this versatile tool. After conquering BASIC language, an assembler is the next 
logical step. 

The Atari Assembler Cartridge provides the ideal tool. It is powerful, and 
yet simple to understand and use. It provides all the features necessary to take 
the drudgery out of hand assembling machine language programs. 

We have written this book with two main objectives in mind: 

(1) to provide simple, detailed directions for using the Atari Assembler 
Cartridge; 

(2) to provide fundamental information on programming in assembly 
language. 

The book is written for the beginning assembly language programmer who 
has some knowledge of BASIC language programming. Steps for using the assem¬ 
bler are given in detail. Sketches of the video screen are shown at intermediate 
and final stages for entry and execution of programs. Machine language instruc¬ 
tions are explained both verbally and pictorially. Every effort has been made to 
make the book easy to read and understand. 

We believe the approach to assembly language programming through 
BASIC is sound. We assume you have a knowledge of BASIC, and we try to ease 
you gently into assembly language using your existing knowledge of BASIC. 

Chapter exercises and answers are given to reinforce what you have learned. 
Although the book is not meant to cover the Atari Assembler Cartridge or the 
6502 instruction set completely, it provides enough detail to allow you to use 
both at an intelligent level. From that point, you are encouraged to use what 
you have learned to explore assembly language to the depth that you desire. 


xi 





Chapter 1 


Introduction 


This book is primarily concerned with the operation and use of the Atari 
Assembler Cartridge. The Assembler Cartridge plugs into the left slot of the 
Atari computer replacing the BASIC language cartridge. 


/ 

7 

7 
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computing 

language 


computing 

language 

/ 


/ 


Assembler BASIC 

Cartridge cartridge 

Figure 1-1. Language Cartridges 


Through the Assembler Cartridge programs, an assembly language program 
is written and edited. It is assembled into machine lanaguage codes, and the ma¬ 
chine language program is then executed to produce the desired results. The 
steps in this procedure are outlined in Figure 1-2. 



Figure 1-2. Steps in Assembly Language Programming 
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Our discussion of the Assembler Cartridge and its use will begin in Chapter 
4. Instead of jumping right into the cold waters of assembly language program¬ 
ming, you should try a more gentle approach. In this chapter and the next, you 
will learn about the Atari’s organization (or architecture) and go through a quick 
review of its BASIC language, with which we assume you are familiar. You will 
learn to create and execute machine language programs from within a BASIC 
program of your own in Chapters 2 and 3 (see Figure 1-3). We are using this ap¬ 
proach because most users of the Model 400 and 800 Atari computers will prob¬ 
ably do most of their programming in the Atari BASIC language supplied in 
cartridge form with their computers. This will allow you to learn the fundamen¬ 
tals of machine language programming through a language with which you are 
already familiar. 



Figure 1-3. Machine Language Subroutine from BASIC 

BASIC language instructions must be translated or interpreted (by the 
BASIC language cartridge) before the computer can understand what is to be 
done. Because of this extra step for translation, instructions in BASIC cannot be 
executed as quickly as instructions written in machine language. A program writ¬ 
ten in BASIC also uses more memory space than the equivalent program written 
in machine language. 

It is possible to write most of a program in BASIC and write parts that 
must be done quickly and efficiently in machine language. The machine language 
parts of the program are accessed as subroutines from the BASIC program. These 
subroutines can be “understood” directly by the computer, and no time is wasted 
for interpretation. Chapters 2 and 3 will thoroughly explain this method and 
provide sample demonstrations and step-by-step instructions. 

Although the computer can execute machine language instructions faster 
than it can execute BASIC instructions, it takes the programmer longer to write 
a machine language program. 

There are several disadvantages to machine language: 

1. Each instruction has its own numeric code which the computer 
understands. The programmer must either memorize these codes (Heaven for¬ 
bid!) or look them up in a table each time they are used: 
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Examples: 

Hex Code Operation Performed 

A9 Load the accumulator with the number follow¬ 

ing the hex code. 

AD Load the accumulator with the number con¬ 

tained in the memory location that follows the 
hex code. 

8D Store the value in the accumulator into the 

memory location that follows the hex code. 

2. Each machine language Operation Code (Op Code) must be placed in 
memory in the correct sequence for the successful operation of the program. 

3. When branches are made to change the sequential operation of a pro¬ 
gram, the programmer must calculate and include in the instruction exactly how 
many memory locations must be skipped to arrive at the correct instruction. 

4. The detail work involved in machine language programming is tremen¬ 
dous, and the chance for programming errors is very high. 

Assembly language eliminates many of the drawbacks of machine language 
programming. Compare the following list to the disadvantages of machine lan¬ 
guage. 

1. Each assembly language instruction has its own mnemonic code which 
is an abbreviation of the operation to be performed. 


Examples: 

Mnemonic 

Code Operand 

LDA #14 

LDA $1100 

STA $1105 


Operation Performed 
Load the accumulator with the 
number 14. 

Load the accumulator with the value 
contained in memory location 1100. 
Store the value contained in the 
accumulator in memory location 
1105. 


These mnemonic codes are much easier for a programmer to work with 
than the numeric codes of machine language. 

2. The assembly language program has line numbers similar to 
BASIC, and the program is automatically placed into the correct sequence 
of memory locations by the assembler. 

3. Through the use of labels (combinations of words, letters and/or 
numbers) branches are made to labeled instructions, and no calculations 
are required (the assembler does it for you). 
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4. The assembler creates the machine language program for you 
from the mnemonic codes, eliminating all the time-consuming detail work. 

The chance for programming errors is much less than for programs con¬ 
structed by hand in machine language. 

The Atari Assembler Cartridge will be introduced in Chapter 4 after you 
learn a little more about how the computer works in its own language. 

COMPUTER ARCHITECTURE 

We assume that you are familiar with your Atari BASIC programming lan¬ 
guage and now wish to investigate the computer’s capabilities through its own 
language. 

Programming in the machine’s language requires that you become familiar 
with the fundamental building blocks (or architecture) of the Atari computer. 
The two building blocks that you will be most concerned with are the Central 
Processing Unit and the computer’s memory. 


6502 

Central Processing Unit 
(CPU) 


Memory 


Figure 1-4. Atari Building Blocks 


You will need an understanding of how the computer’s memory is used for 
storage and retrieval of information. You will get to know the binary codes used 
to “instruct” the computer. These codes are referred to as the instruction set of 
the Central Processing Unit. 

It sounds very complicated, but we will move slowly. One thing will be 
introduced at a time, and we will repeat previously discussed information at fre¬ 
quent intervals. 

The Atari 400 and 800 model computers use a Central Processing Unit 
(CPU) called the 6502. The 6502 is a member of a family of microprocessors de¬ 
veloped by MOS Technology, Inc., the MCS650X product family. This CPU can 
process, or execute, a set of instructions (listed in Appendix A) that are identi¬ 
fied by their machine language codes. The codes are composed of binary num¬ 
bers that are 8 binary digits (bits) long. 

Binary digits come in two denominations. A binary digit is either a 1 (one) 
or a 0 (zero). A machine language code which can be recognized by the 6502 
CPU is made up of 8 of these binary digits. 
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Examples: 
Binary code 
10101001 

10101101 

10001101 


Instruction 

Load the accumulator with the number following 
this instruction. 

Load the accumulator from the memory location 
that follows this instruction. 

Store the value that is in the accumulator in the 
memory location that follows this instruction. 


Note that each code is exactly 8 binary digits (8 bits) long. The block of 8 bits is 
called a byte. The accumulator, mentioned in the instruction, is a special storage 
location called a register. It can hold one byte of data at a time. 

The accumulator (often referred to as register A) is probably the busiest 
register (a special temporary storage location) in the system. All operations be¬ 
tween memory locations must be communicated through the accumulator or 
one of the other registers. The accumulator is used as a temporary storage when 
moving data from one memory location to another. Operations on data are per¬ 
formed in the accumulator. Therefore, it is used in many of the machine lan¬ 
guage and assembly language instructions. It “accumulates” the results of succes¬ 
sive operations on data as the instructions request. 

It is convenient for a programmer to think of the 6502 microprocessor as 
consisting of several functional elements. Figure 1-5 shows the registers (special 
storage locations within the CPU) that are used repeatedly as the computer per¬ 
forms its many and varied chores. Some of these elements are used for specific 
purposes, and others are used for general purposes as needed by the programmer. 


I I The 8-bit accumulator (A) 

I | The 8-bit X Index register (X) 

| ~| The 8-bit Y Index register (Y) 

I 1 The 16-bit program counter (PC) 

| ~| The 16-bit stack pointer (S) 

I I The 8-bit Processor Status Register (P) 

Figure 1-5. 6502 Functional Elements 


Data is transferred between memory and the processor’s internal registers 
over 8 bidirectional data lines called the data bus. Each bit of a data byte passes 
along its own line. However, the transfer of the whole byte (all 8 bits) of data 
takes place at the same time. Even though each bit travels along a separate path 
(line) of the data bus, the byte is transferred as one complete unit. Thus the 
structure of the 6502 microprocessor is said to be a byte-oriented structure. The 
8 lines together are referred to as a bus. 
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Bidirectional 
data bus 
(data passes in 
either direction) 


Figure 7-6. 8 Line Data Bus 

The X and Y registers are also used for temporary data storage. In addi¬ 
tion, they have the ability to be incremented and decremented by a programmed 
instruction. When the X or Y register is incremented, the value in the register is 
increased by one. When X or Y is decremented, the value in the register is de¬ 
creased by one. Therefore, the X and Y registers can be used as counters (or 
pointers) to store data into successive memory locations or to load data from 
successive memory locations. This ability to point to successive memory loca¬ 
tions is called indexing (hence their name: index registers). They can also be 
used as counters to determine conditions for ending a series of repeated opera¬ 
tions (a loop). The 6502 instruction set includes several special instructions to 
load the index registers with predetermined values to facilitate the execution of 
loops in a manner similar to BASIC language FOR-NEXT loops. 

The 16-bit program counter acts as a program address pointer to assure 
that instructions are executed in the desired order. Instructions of a program are 
stored in consecutive locations in memory. They are made up of machine lan¬ 
guage operation codes and/or address bytes and numbers to be operated on. To 
control the desired sequence of operations of a program, the program counter is 
used as a pointer to designate the position in memory where the microprocessor 
will obtain each successive instruction. The program counter is incremented, after 
each instruction is “fetched,” to point at the next instruction to be performed. 



Figure 1-7. Program Counter 


The stack is a special area of memory that is used to save data according 
to the sequence in which it is stored. It acts like a Last-In, First-Out file system 
(Figure 1-8). The 16-bit stack pointer keeps track of where data has been stored 
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Figure 1-8. Last-In, First-Out Stack 



within the stack. It contains an address designating the current location of the 
top of the stack. The stack pointer and the program counter are large enough 
(16 bits) to hold a full-length address (0 through 65535). 

Individual bits of the 8-bit Processor Status Register are used to keep track 
of specific effects that instructions have on the “status” of the computer. The 
presence or absence of an effect is shown by whether a particular bit has been 
set to one or reset to zero. These individual bits are also called flags. Flags used 
by the 6502 microprocessor are Carry, Zero, Interrupt, Decimal, Break, Over¬ 
flow, and Negative. These conditions (or effects) are discussed in more detail as 
they are needed in understanding the instructions. Your first encounter will be 
with the Carry flag in Chapter 2. 


Bit number 


Flag 


7 I 6 I 5 


3 2 10 


N I V I IB|D|I|Z|C 



Carry 
Zero result 
Interrupt disable 
Decimal mode 
Break command 
Expansion 
Overflow 
Negative result 


Figure 1-9. Processor Status Register 


REVIEW OF BASIC 

In Chapter 2, we will introduce the use of machine language programs that 
are entered through the use of BASIC language programs. The machine language 
program will be a subroutine of the BASIC program. Atari’s BASIC includes a 
function that is used to transfer from the BASIC program to such a machine lan¬ 
guage subroutine. It is known as the USR function. 

Example: 

120 X = USR(IOOO) 


"Go to the machine language sub¬ 
routine at memory location 1000 
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The balance of this chapter is devoted to the review of some of the BASIC 
statements, commands, functions, and keywords used by the Atari 400/800 
computers. Special attention should be given to the USR function as well as the 
POKE, PEEK, and ADR keywords. If you feel the review unnecessary, proceed 
to Chapter 2. 

Atari BASIC uses statements and keywords that are different from other 
BASIC language versions due to the computer’s special graphics and sound capa¬ 
bilities. These are briefly described here. For more complete descriptions refer to 
the Atari BASIC Reference Manual. 


Graphics Keywords 

COLOR Primarily selects the appropriate color register, but specific uses de¬ 
pend on the graphics mode in use. 

DRAWTO Draws a line from a PLOTted point to the point specified. 

FILL Not really a keyword but an I/O operation that fills an area on the screen 
between plotted points and lines with a specified color. 

GET Used to input the code byte for the character displayed at the cursor 
location. 

GRAPHICS Controls which graphics mode is to be used. 

LOCATE Stores the color number that controls a particular point on the screen 
in the specified variable. 

PLOT Plots a point in the graphics window based on the X,Y coordinates speci¬ 
fied. 

POSITION Places the cursor at a particular location on the screen. 

PUT Used to output data to the screen for display. 

SETCOLOR Sets the color register specified by loading it with the hue and 
luminance data specified. 

Sound and Game Keywords 

PADDLE Returns the status of the specified controller (a number between 1 
and 228 depending on paddle position). 

PTRIG Returns a number representing the status of the trigger button of a con¬ 
troller (0 if button pressed, otherwise 1). 

SOUND Plays a note through one of four specified voices, with the pitch, dis¬ 
tortion, and volume specified. 

STICK Same function as PADDLE, but for joystick controllers. 

STRIG Same function as PTRIG, but for joystick controllers. 
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Special Keywords 


Four keywords that are of special importance to us are: ADR, PEEK, 
POKE, and USR. These words provide a link between BASIC and machine lan¬ 
guage programs. 

ADR This function returns the memory address of a specified string. Knowing 
the address enables the programmer to pass data to USR subroutines. A 
two-step process is used to obtain the address of a matrix of numeric val¬ 
ues. First use a DIM statement for a string of length 1. On a separate 
BASIC program line, ask for the address of the string variable. 


Example: 

200 DIM A$(1) 



210 PRINT ADR(A$) 


The address of the matrix will be one more than the address of the string 
A$. 

The ADR function must be used with care. If your program (made 
up of the data matrix) is not addressed correctly, the computer may go off 
to Never-Never Land (the wrong place) and not return. If this happens, 
you can turn the computer off, wait about 5 seconds, and power up again. 
Your program will have gone bye-bye in the meantime. Start all over again. 
PEEK This function allows the user to PEEK into a specified memory location. 
The user can then make use of the information that is “seen” there in his 
BASIC program. 


Examples: 

200 PRINT "THE LEFT MARGIN IS SET AT”; PEEK(82) 


This memory locational ways contains 
the position at which printing on the 
screen begins for each line (ordinarily 2). 


210 PRINT “ THE RIGHT MARGIN IS SET AT”; PEEK(83) 


This memory location contains the right¬ 


most position at which a character is 
printed on the screen (ordinarily 39). 


Any memory address (given in decimal form) in your Atari may be PEEKed 
at without disturbing its contents. This applies to either ROM (Read Only 
Memory) or RAM (Random Access Memory). RAM is the kind of memory 
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that may be either written into or read from. ROM can only be read from. 
We will often use this instruction in Chapter 2 to PEEK at machine lan¬ 
guage programs that we have entered in memory. 

POKE This function is the opposite of PEEK. You can use it to insert or mod¬ 
ify the contents of RAM memory. We will use it in Chapter 2 to POKE in 
machine language programs. 

Examples: 

150 POKE 82,8- 

160 POKE 83,30 


'Change the left margin for screen 
printing to position 8 
" Change the right margin to 30 


This would perform the following function. 


0123456789012345678901234567890123456789 
PRINTED MATTER ACCEPTED 
ONLY FROM POSITION 8-30 


Screen 

positions 

(0-39) 


POKE, like PEEK, can be used in either the direct or deferred program 
mode. You cannot POKE data into ROM memory. Data can only be read 
from ROM, not written. Since a POKE statement actually changes data 
stored in memory, great care must be taken when using it. If incorrect data 
is POKEd into memory or if data is POKEd into the wrong memory loca¬ 
tion, disastrous results may occur. When you want to use POKE, refer to 
the Atari memory map in Appendix G of the Atari BASIC Reference 
Manual. 

One precaution before indiscriminately using POKE. PEEK first 
and write down the value in that memory location into which you wish to 
POKE. Then, if the POKE doesn’t produce the desired result, you can 
POKE the original value back where it was. 


USR This function “calls” a 6502 machine language subroutine and returns 
with the result of the subroutine’s execution. It will be used in Chapter 2 
to execute the machine language programs that are POKEd into memory. 
The format used for this function is: 


USR(X,Y,Z,.. 


An integer or 
arithmetic expression 
that evaluates to an 
integer. It is the deci¬ 
mal address of the be¬ 
ginning of the machine 
language program. 


Optional input arguments 
(variables that are passed 
to the subroutine) 
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Definitions 

The following definitions were condensed from the Atari BASIC Refer¬ 
ence Manual for a quick review. 

ARRAY A list of places where items can be filed away for future use. 

ARRAY VARIABLE A name for an array consisting of one or more elements. 
BASIC statement Similar to a sentence in English; requests the computer to do 
something. 

BREAK KEY Pressed to stop a program’s execution. 

CONCATENATION The joining of two or more strings. 

CONSTANT A number or string without a variable name. 

DEFERRED PROGRAMS Those stored in memory (with line numbers) for 
future execution. 

DIRECT PROGRAMS Those executed immediately as each line is entered from 
the keyboard. 

EXPRESSION May consist of any combination of legal variables, constants, 
operators, and functions used together. 

FUNCTION A computation built into the computer’s operating system so that 
it can be used by the user in his programs. 

KEYWORD Any reserved word used by BASIC that cannot be used for other 
purposes. 

LOGICAL LINE Each numbered line in a BASIC program; consists of one to 
three physical video screen lines terminated by a RETURN. 

NESTED LOOP One loop (inner loop) executed within another (outer loop). 
OPERATOR Symbols used to perform operations such as arithmetic, compari¬ 
son or logic. 

RETURN KEY Pressed to enter each program line. 

STRINGS A group of characters strung together with quotes. 

VARIABLES The name for a number or string. 

For a complete list and discussion of Atari BASIC, refer to the Atari 
BASIC Reference Manual. With this brief review let’s move right on to Chapter 2. 



Chapter 2 


Machine Language 
from BASIC 


Short machine language programs can be written and executed from 
BASIC through the use of the USR function. In this way, it is possible to exe¬ 
cute part of a program in BASIC, "jump” to a machine language subprogram and 
then return to BASIC again. Figure 2-1 shows the flow of such a program. 



The computer can only understand instruction codes written in fixed-length 
binary numbers. These binary instruction codes are called machine language. 

BINARY NUMBER PATTERNS 

The computer interprets these bits as being one of two numeric symbols, 0 
or 1. The pattern of 1 ’s and 0’s makes a meaningful word, or a complete idea, to 
the computer. Therefore, we need to learn these words if we are to communicate 
directly with it. 


12 




BIN A R Y NUMBER PA TTERNS 13 



An example of a pattern of 8 computer bits (a pattern with a size and 
shape that the computer can understand) is shown. 

0 10 110 11 

OFF ON OFF ON ON OFF ON ON 

The computer would recognize this pattern as a unique number code and 
would respond by taking a specific action or using the number as a specific piece 
of data. 

The Central Processing Unit (CPU) of the Atari computer was originally 
manufactured by MOS Technology, Inc. At the present time, two other com¬ 
panies (Synertek and Rockwell) also manufacture the CPU. This unit is named 
the 6502 microprocessor. It is called a Central Processing Unit because all instruc¬ 
tions and numerical values are routed there for processing. 

The 6502 microprocessor (and hence, the Atari computer), like many other 
microprocessors, only understands instructions which are coded in blocks of eight 
binary digits, called bytes. Therefore, the biggest hurdle to machine language 
programming is to learn to work with information in binary form. 


| 0 1 1 

1 1 1 0 1 1 

*- block of 8 bits or 1 byte 


m 

one bit 


M ol 

*- two bits (not worth much these days) 


1 1 i 

<- four bits (sometimes referred to as a 
nybble) 

I 0 1 1 

1 1 1 0 1 | 

«- eight bits (commonly called a byte) 


The Atari uses words that are eight bits in length, that is, it can digest 
words whose size is one byte. All instructions and numerical values must be sent 
to its Central Processing Unit in this byte size. A typical instruction, shown be¬ 
low, loads the computer’s accumulator with the one byte of data following the 
instruction in a machine language program. 
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Load Accumulator from the L Register] 

MNEMONIC CODE 
(Abbreviation) 

BINARY CODE 

LDA 

10101001 


Don’t let the computer terminology throw you. The accumulator is similar 
to a memory location that is used in special ways which we will discuss later on. 
We are just introducing it here to show the format of an instruction. 

The BASIC Language Cartridge, provided with your Atari, automatically 
interprets BASIC language statements and decimal numbers so that the compu¬ 
ter can understand them. Therefore, when you are programming in BASIC, you 
enter decimal numbers and the results are displayed as decimal numbers even 
though the computer is working with binary numbers. 


HEXADECIMAL NOTATION 

Machine language codes are usually given in a third number system called 
hexadecimal. The hexadecimal system has a base of 16 and is used as a short¬ 
hand to represent binary numbers. Figure 2-2 shows a chart that demonstrates 
equivalent decimal, binary, and hexadecimal numbers. 


Decimal 

Binary 

Hexadecimal 

0 

0000 

0 

1 

0001 

1 

2 

0010 

2 

3 

0011 

3 

4 

0100 

4 

5 

0101 

5 

6 

0110 

6 

7 

0111 

7 

8 

1000 

8 

9 

1001 

9 

10 

1010 

A 

11 

1011 

B 

12 

1100 

C 

13 

1101 

D 

14 

1110 

E 

15 

1111 

F 


Figure 2-2. Decimal-Binary Hexadecimal Equivalents 





HEXADECIMAL NOTATION 15 


We will often refer to this shorthand as hex. Four binary digits may be 
represented by one hex digit. Thus, our 8-bit instruction may be represented by 
a 2-digit hex number by breaking the byte (8 bits) into two parts. 

Binary Number 


lO 1 1 1 1 1 0 ll 



0111 = 7 hex 0ne Tw ° 1101 = D hex 


Binary 

Therefore: 01111101 


Each place value in the binary system is a power of two, just as each place 
value in the decimal system is a power of ten. Two is called the base of the bi¬ 
nary system, and ten is called the base of the decimal system. If we look at the 
place values of the binary numbers 0000 through 1111, we can attach more 
meaning to them. 


Two Parts HEX 



Binary Places 

Decimal 

Equivalent 

2 3 2 2 2 1 2° 

0 0 0 1 

0 0 10 

0 10 0 
10 0 0 

0+0+0+1 = 1 
0+0+2+0 = 2 

0+4+0+0 = 4 
8+0+0+0 = 8 


Using combinations of these place values, we may obtain any decimal value from 
0 through 16 or any hex value from 0 through F. 


Examples: 
0101 = 2 2 

1001 = 2 3 

1100 = 2 3 

1011 = 2 3 


2° =4+1=5 decimal and also 5 hex 
2° =8+1=9 decimal and also 9 hex 
2 2 = 8+4 =12 decimal which is C hex 
2 1 + 2° = 8+2+1 =11 decimal which is B hex 


Let’s now take a closer look at how we may express any 8-bit binary num¬ 
ber by two hex digits. We saw earlier that the highest hex digit (F) corresponds 
to the four-bit binary value 1111. The next higher binary value is 10000. The 
one is in the 2 4 place which equals 16. Therefore, we have one 16 and nothing 
else. This can be expressed by the hex value 10, which means one 16 and no 1 ’s. 
There is a direct relationship between upper 4 bits of an 8-bit binary number and 
the sixteen’s place digit of a hex number. 
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Binary Places 

Hex value 
16 1 

2 i 2 e 2 s 2 4 

0 0 0 1 

1 

0 0 10 

2 

0 10 0 

4 

10 0 0 

8 


Next look at the binary place values of the complete 8-bit number. 


Binary Places 

Decimal 

Equivalent 

Hex 

Equivalent 

2 7 

2 6 

2 s 

2 4 

2 3 

2 2 

2 1 

2° 

0 

0 

0 

0 

0 

0 

0 

1 

0+0+0+0+0+0+0+1 =1 

1 

0 

0 

0 

0 

0 

0 

1 

0 

0+0+0+0+0+0+2+0 = 2 

2 

0 

0 

0 

0 

0 

1 

0 

0 

0+0+0+0+0+4+0+0 = 4 

4 

0 

0 

0 

0 

1 

0 

0 

0 

0+0+0+0+8+0+0+0 = 8 

8 

0 

0 

0 

1 

0 

0 

0 

0 

0+0+0+16+0+0+0+0 = 16 

10 

0 

0 

1 

0 

0 

0 

0 

0 

0+0+32+0+0+0+0+0 = 32 

20 

0 

1 

0 

0 

0 

0 

0 

0 

0+64+0+0+0+0+0+0 = 64 

40 

1 

0 

0 

0 

0 

0 

0 

0 

128+0+0+0+0+0+0+0 = 128 

80 


Figure 2-3. Eight-bit Conversion 


Using combinations of all eight bits, you may obtain any decimal value 
from 0 through 255, or any hex value from 0 through FF. If we break an 8-bit 
binary number into two four-bit parts, each part may be represented by one hex 
digit. 


Examples: 

Binary 

01101101 

64+32+8+4+1 = 109 in decimal 

Split binary 

01101101 


Hex 

6 D 

6*16+13 = 109 decimal 

Binary 

11000101 

128+64+4+1 = 197 in decimal 

Split binary 

1100 0101 


Hex 

C 5 

12*16+5 = 197 decimal 

Binary 

10101100 

128+32+8+4 = 172 in decimal 

Split binary 

10101100 


Hex 

AC 

10*16+12 = 172 decimal 


HEXADECIMAL-TO-DECIMAL CONVERSION 

Flex codes made up of one digit are quite easily converted to decimal val¬ 
ues. If you haven’t memorized the equivalents by now, here is a table of the 
values again. 





HEX A DECIMAL-TO-DECIMA L CONVERSION 17 


Hexadecimal 

Decimal 

0 

0 

2 

2 

3 

3 

4 

4 

5 

5 

6 

6 

7 

7 

8 

8 

9 

9 

A 

10 

B 

11 

C 

12 

D 

13 

. E 

14 

F 

15 


Figure 2-4. Hex Digit-to-Decima! Conversion 


A two-digit hex code is also easily converted to its decimal equivalent if we 
keep in mind two things: 

1. The decimal equivalent of each hex digit (as in the previous table). 

2. The place value assigned to each hex digit. 

Place values in the decimal number system are powers of ten. The least sig¬ 
nificant place in a decimal integer is valued at 10°. This is called the one’s place 
(10°=1). The next place to the left is valued at 10 1 and is called the ten’s place 
( 10 1 = 10 ). 


Examples: 

89 = (8 x 10 1 ) + (9 x 10°) 
or 

(8x10)+ (9x1) = 80 +9 

digit place digit place 
ft value value 

23 = (2 x 10 1 ) + (3 x 10°) 
or 

(2x10)+ (3x1) = 20+ 3 


The hexadecimal place values are powers of sixteen (hexadecimal = 6 and 
10). The least significant place in a hex integer is valued at 16°. This is the one’s 
place (16°=1). The next place to the left is valued at 16 1 and is called the six- 
teen’s place (16 1 =16). 




18 MACHINE LANGUAGE FROM BASIC 


Examples: 

23 hex = (2 x 16 1 ) + (3 x 16°) 


(2x16)+ (3x1)-32+ 3 decimal 

y / ■ 

place 

value digit 


IV 


place 

value 


89 hex = (8 x 16 1 ) + (9 x 16°) 
or 

(8 x 16) + (9 x 1 ) = 128 + 9 decimal 
= 137 decimal 


A9 hex = (10 x 16 1 ) + (9 x 16°) 
or 

(10 x 16) + (9x1)= 160+ 9 decimal 
= 169 decimal 


See if you can fill in the decimal equivalents of the following hex codes. 


Hex 

Decimal 

Code 

Equivalent 

68 


18 


A9 


3F 


69 


41 


8D 


00 


18 


60 



Figure 2-5. Hex Code Conversion Exercise 

If you have converted the hex codes of Figure 2-5 correctly, you are ready 
to enter your first machine language program. The codes are machine language 
instructions and data. Remember though, you are entering them from a BASIC 
program. Therefore, you must use the decimal form for entry. Check your an¬ 
swers now by looking at Figure 2-7. 

Before the discussion of the machine language subroutine, let’s take a look 
at the BASIC program used to enter and execute the subroutine. 
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BASIC PROGRAM-ADD TWO NUMBERS 

100 REM INITIALIZE STORAGE ADDRESS 

110 CLR: DIM E$(1), E(10) 

120 REM POKE IN SUBROUTINE 

130 FOR Y = 1 TO 10 

140 INPUT N 

150 POKE ADR(E$)+Y,N 

160 NEXTY 

170 REM CALL SUBROUTINE 
180 X=USR(ADR(E$)+1) 

190 REM PRINT RESULTS 
200 GR.0:PRINT “THE SUM IS 
210 PRINT PEEK(6144) 

220 END 

Notice line 110. After the DIM statement for E$, it is necessary to dimen¬ 
sion an array (E in this program) to the number of codes that are being used in 
the machine language program. This saves the necessary memory locations to re¬ 
ceive the codes POKEd in by the FOR-NEXT loop in lines 130 through 160. 

A flow diagram for the BASIC program and its machine language subrou¬ 
tine is shown in Figure 2-6. 



Figure 2-6. Flowchart 
for Addition Subroutine 
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When you type RUN, the machine language subroutine is POKEd into 
memory. Each time through the input loop, enter one decimal equivalent of one 
hex code following the question mark (input prompt). The inputs are the deci¬ 
mal values that you put in Figure 2-5. 



You are adding these 
two decimal numbers 


Figure 2-7. Decimal Equivalents of Hex Codes 


After all 10 codes have been entered, the machine language subroutine is 
executed. On return from the subroutine the result is printed. 

Enter the program and RUN it. This is the way it should look on the 
screen just before you press RETURN after the ninth input. 

^?104 
?24 
?169 
?63 
?105 
?65 
?141 
?0 
?24 

?96 -*-The 10th input 

After you press RETURN the tenth time, the screen is cleared and your 
result appears. 


THE SUM IS 128 
READY 
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Congratulations! You have just completed your first machine language 
program. When your BASIC program executed line 180, the USR function 
caused the execution of the machine language subroutine. 

Figure 2-8 shows each hex code, the mnemonic code that will be used 
when you use Assembler language, and an explanation of the purpose of each 
code. 


Hex 

Code 

Mnemonic 

Code 

Explanation 

68 

PLA 

Pull one byte off the stack and place it in the accu¬ 
mulator 

18 

CLC 

Clear the Carry flag 

A9 

LDA 

Load the accumulator with the value immediately 
following 

3F 


Value loaded (3F hex = 63 decimal) 

69 

ADC 

Add the hex value that follows to the value in the 
accumulator 

41 


Value added (41 hex = 65 decimal) 

8D 

STA 

Store the value in the accumulator into the memory 
location that follows 

00 


Least Significant Byte of memory 

18 


Most Significant Byte of memory 

60 

RTS 

Return from subroutine 


Figure 2-8. Machine Language Subroutine 

Notice that some codes consist of single bytes (68, 18, 60), some consist 
of two bytes (A9 and 3F, 69 and 41), and one consists of three bytes (8D and 
00 and 18). Data and memory addresses accompany the appropriate instruction 
to form multi-byte instructions. 

HOW THE MACHINE LANGUAGE PROGRAM WORKS 

So far, we have said little about the the individual machine language codes. 
These codes have little or no meaning to you at this time, but each does have a 
precise meaning to the computer. Let’s consider them in the following groups. 


1. 68 

2. 18 
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3. A9 3F 

4. 69 41 

5. 8D00 18 

6. 60 


1. The first instruction (68) is the machine language code that tells the 
computer to pull one byte of data off the stack and place it in the accumulator. 

The stack is a special area of memory where the computer keeps certain 
numbers and addresses in a specific order for later use. Each new item going 
onto the stack is placed on top of the stack. All other items are “pushed down” 
one place when a new item goes on top. 


Example: 


3 items on the stack 

New item _jr—i 


New item is pushed on from the top. 

When the USR function “calls" a machine language program from BASIC, 
the BASIC address to which the machine language is to return when done is 
placed on the stack in two separate bytes—low-address byte first, then high- 
address byte on top. 

Top 


Bottom 

The Stack 


yy High byte of return address 


xx *- Low byte of return address 




Following this, the computer puts any variables being passed to the machine lan¬ 
guage subroutine. The last item placed on the stack at this time is the number of 
variables that were passed. In our example, we didn’t pass any variables. There¬ 
fore the stack looked like this when the machine language subroutine was called. 


Top 


Bottom 


0 <- Number of variables passed 

yy ■<- High byte of return address 
xx Low byte of return address 


In order to have the return address available when the subroutine has been com¬ 
pleted, we had to remove that zero on top of the stack. So, we used the instruc- 
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tion (68) to pull the top value off the stack. It was placed in the accumulator by 
the instruction. The stack now has the return address on top ready for use. 



The Stack Now 


B 


High byte of return address 
Low byte of return address 


The Accumulator Now 


The number (0) in the accumulator will not be used, but we had to get it off 
the stack in order to access the return address bytes when needed. 

2. The second instruction (18) clears the Carry bit of the Processor Status 
Register (resets it to zero). The add instruction (fourth instruction) will auto¬ 
matically add the Carry bit when two numbers are summed. Since you do not 
want a carry to be added in, the instruction is used to ensure that the Carry bit 
is zero. Later, you will be doing some multiple-byte additions with larger num¬ 
bers. At that time, you will see that the Carry bit must be used when adding all 
but the Least Significant Byte. 

3. The third instruction consists of two hex codes (or two bytes): 

A9 3F 

A9 is the hex representation for the instruction, “Load the accumulator with the 
value that immediately follows.” The 3F is the number that is loaded. 

4. The fourth instruction consists of the two hex codes (two bytes): 

69 41 

69 is the hex representation for the instruction “Add the number that follows to 
the value in the accumulator.” The result will replace the value in the accumula¬ 
tor. The hex value 41 is the number that is added. 

5. The fifth instruction consists of three hex codes (three bytes): 

8D0018 

8D is the hex representation of the instruction, “Store the value that is in the 
accumulator into the memory location that follows.” The memory location used 
is 1800 hex (6144 decimal). Notice that the memory location is too large to be 
expressed as one byte. Therefore, two hex codes are used. Notice also the order 
in which the high-address byte (18) and the low-address byte (0) are given. The 
low-address byte is first, followed by the high-address byte. This convention is 
followed when instructions contain a two-byte address. 

6. The last instruction consists of a single hex code (one byte): 

60 

60 is the hex representation of the instruction, “Return from subroutine.” This 
single instruction tells the computer to return to the place where it came from. 
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The computer takes the top two bytes off the stack in order to find where it 
should return in the BASIC program and obtain the next BASIC statement. 

A machine language program is executed in sequential order by memory 
locations just as a BASIC program is executed by line numbers. There are excep¬ 
tions like the BASIC GOTO and GOSUB statements. Machine language programs 
can perform similar tricks with JUMP and BRANCH instructions, as you will see 
later. 

Although this book is mainly concerned with Assembly Language pro¬ 
gramming and the Atari Assembler Cartridge, you should realize that the com¬ 
puter actually works with machine language codes. The assembler language is 
merely an easier method to remember and enter machine language codes, as you 
will see in later chapters. 

We have used six machine language instructions in this first program. Since 
machine language instructions are coded numbers, they are hard to remember. 
However, each one of them has a mnemonic code (an abbreviation for the mean¬ 
ing of the instruction) that is used in assembly language programming. 


INSTRUCTIONS USED SO FAR 


Machine 

Language 

Code 

Assembler 

Mnemonic 

Function 

68 

PLA 

Pull one byte off the stack and place in the 
accumulator 

18 

CLC 

Clear the Carry bit 

A9 

LDA 

Load the accumulator with the hex value 
that follows 

69 

ADC 

Add (with carry) the hex value that follows 
to the accumulator 

8D 

STA 

Store the value in the accumulator into the 
memory location that follows 

60 

RTS 

Return from the subroutine 


SUMMARY 

In this chapter, you have learned: 

• To access a machine language subroutine from a BASIC program by the 
USR function of BASIC; 
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Machine 

language 

subroutine 


That machine language instruction codes are binary numbers that can 
be entered in hexadecimal form; 

That some instruction codes occupy one byte, some two bytes, and 
some three bytes; 

How the “push down” stack is used to store numbers and addresses 
temporarily; 

How the numbers are pulled off the stack; 

That every machine language subroutine must have a Return from Sub¬ 
routine instruction to send control back to the main program; and 
The following machine language instructions: 


68 

A9 

69 

8D 

60 

18 


PLA Pull one byte off the stack and place it in the 
accumulator 

LDA Load the accumulator with the value imme¬ 
diately following 

ADC Add the hex value that follows to the value in 
the accumulator 

STA Store the value in the accumulator into the 
memory location that follows 

RTS Return from Subroutine 

CLC Clear the Carry flag 


EXERCISES 

1. Hexadecimal codes are a short way to write _ instruc- 

(decimal, binary) 

tion codes which the computer can understand. 

2. What kind of numbers are used in BASIC language programs? 


(binary, hex, decimal) 
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3. Fill in the hexadecimal and decimal equivalents of the following binary num¬ 
bers. 

(a) 1101= _ hex = _ decimal 

(b) 0110= _ hex = _ decimal 

(c) 10101001= _ hex = _ decimal 

4. When using a machine language subroutine from BASIC, you enter instruc¬ 
tion codes in __ form, and the BASIC interpreter converts them 

(hex, decimal) 

to _form. 

(hex, decimal) 

5. What is the three-letter abbreviation for the function used in Atari’s BASIC to 

call a machine language subroutine?_ 

6. If you want to call a machine language program from BASIC and had dimen¬ 
sioned the variable E$ to 1 (100 DIM E$(1)) for this purpose, what is the 
BASIC line that would call the subroutine? 

500 _ 

7. What is the last instruction that every machine language subroutine must exe¬ 
cute to get back to the BASIC program? 


8. Suppose you wish to store the decimal value, 72, in the memory location 
1925 hex. The number 72 is now in the accumulator. The machine language 
instruction to store the value would consist of three bytes in the following 
order. Fill in the blanks. 

8D 


9. In exercise 8, what hex value would be loaded into memory location 1925? 


ANSWERS 

1. Binary 

2. Decimal 

3. (a) 1101 = D hex = 13 decimal 

(b) 0110 = 6 hex = 6 decimal 

(c) 10101001 = A9 hex = 169 decimal 

4. Hex 
Decimal 
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5. USR 

6. 500 X = USR(ADR(E$)+1) 

^--—--This may be some other variable 

7. 60 or RTS or Return from Subroutine 

8. 8D 

25 (Don’t forget the reverse order) 

19 

9.48 (4*16+8 = 72) 



Chapter 3 


Memory Use 


When you use BASIC language and machine language programs together, 
you must use separate portions of memory for each language. Atari’s BASIC in¬ 
terpreter (in the BASIC ROM Cartridge) takes care of allocating the memory lo¬ 
cations used in the BASIC language part of your program. You must make sure 
that your machine language part uses a different area of memory. 

ATARI MEMORY MAP 

Certain areas of the computer’s 65536 memory locations are used by the 
Atari Operating System (8K of ROM) and by the ROM cartridges (such as 
BASIC or Assembler) that may be plugged into the computer console. We can¬ 
not POKE machine language programs into these areas. The Operating System 
and ROM cartridges also use some of the system’s RAM space. We must not 
POKE into those areas as we might destroy our own program or cause some 
other programming disaster. 

Figure 3-1 shows a map of the Atari’s memory. Look closely and you can 
see areas of memory called Free RAM. These areas may be safely used for your 
programs. However, as stated above, you must keep BASIC and machine lan¬ 
guage programs separated. 

High memory 


Low memory 

Figure 3-1. Memory Map 


MEMORY USES 


Operating system, floating 
point arithmetic, hardware 
registers, and other dedicated 


FREE RAM for your use 


BASIC program, variables, etc. 


Operating system and BASIC 
dedicated uses 


28 
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BASIC Program 


Machine Language 
Program 


Separate blocks 
of memory 


The technique which we have been using so far is to DIMension a string 
variable E$ to one (1). This saves one memory location immediately following 
the area used by our BASIC program. The address of this location will vary from 
program to program depending on the length of the BASIC program, but the ma¬ 
chine language memory locations will always follow the BASIC program. We will 
demonstrate this with three short BASIC programs which are of different lengths. 
They all end by printing the address of the memory location saved for E$. 

DEMO PROGRAM #1 


10 CLR: DIM E$(1) 

20 PRINT ADR(E$) 

Enter and RUN Demo Program #1. You will see that one location was 
saved for E$ at address 11182. 


RUN 

11182 

READY 


DEMO PROGRAM #2 


10 CLR: DIM E$(1) 

20 FOR X = 1 TO 10 *- A very short time delay 
30 NEXT X 
40 PRINT ADR(E$) 

Enter and RUN Demo Program #2. You will see that the location saved 
for E$ is now at address 11221. Since Demo Program #2 is longer than Demo 
Program #1, the location saved for E$ has a higher address. 

^RUN 

11221 


READY 




30 MEMORY USE 


DEMO PROGRAM #3 


10 CLR: DIM E$(1) 

20 FOR X = 1 TO 10 

30 PRINT X; 

40 NEXT X 
50 PRINT 
60 PRINT ADR(E$) 

Enter and RUN Demo Program #3. You will see that the address saved for 
E$ is higher yet because Demo Program #3 is longer than the other two. 


RUN 

12345678910 

11235 

READY 


We have made use of the memory location saved for E$ to find a safe place 
in RAM (out of the way of our BASIC program and other reserved areas) for our 
machine language subroutines. We POKEd the machine language subroutine into 
a memory area that started at the next higher location than that saved for E$. 
We will continue to use this method. 


HOW BASIC FINDS THE MACHINE LANGUAGE PROGRAM 


You may wonder how your BASIC program knows where to find the ma¬ 
chine language subroutine. Let’s take another look at the program used in Chap¬ 
ter 2 that added two numbers. 


First section 

100 REM INITIALIZE STORAGE ADDRESS 
110 CLR: DIM E$(1), E(10) 

Save one memory Save 10 locations for 

location for E$ machine language subroutine 
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Second section 


120 REM POKE IN SUBROUTINE 
130 FOR Y = 1 TO 10 

140 INPUT N POKE 10 hex codes into 

150 POKE ADR(E$)+Y,N successive memory locations 

160 NEXTY (E$+1 through E$+10) 

Third section 


170 REM CALL SUBROUTINE Jump to the machine Ian- 

180 X = USR(ADR(E$)+1) guage subroutine starting in 

memory at address (E$)+1 



Figure 3-2. Memory Used for Machine Language Subroutine 


The fourth section of the BASIC program prints the results of the machine 
language program. 

Fourth section 

190 REM PRINT RESULTS 

200 GR.O: PRINT “THE SUM IS”; «- Print the label 

210 PRINT PEEK (6144) --Print result that the machine 

220 END language program has placed 

in memory location 6144 
(1800 hex) 

The computer saved one location for E$ in an area of memory that is out 
of the way of your BASIC program. At lines 130 through 160, the program 
POKEs the machine language codes into the memory just above the space that 
was saved for E$. Your BASIC program “calls” the machine language program at 
line 180 by the USR function. The USR function specifies the address where the 
machine language program can be found. Thus the USR function works like the 
BASIC statement: GOSUB 
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X = USR(ADR(E$)+1) 


Call for machine I-the subroutine starts 

language subroutine at this address 


The machine language hex codes are stored in memory as follows: 


Memory 

Address 

Hex code 

Stored 

E$+1 

68 

E$+2 

18 

E$+3 

A9 

E$+4 

3F 

E$+5 

69 

E$+6 

41 

E$+7 

8D 

E$+8 

00 

E$+9 

18 

E$+10 

60 


Figure 3-3. Hex Code Storage 

The Atari also has the capability of passing one or more quantities to a 
machine language program through the USR function. 


Example: 


100 A=5 


110 X = USR(ADR(E$)+1,A) 


Pass the value of A to the 
machine language program 


The value of variable A is palced on the stack as described in Chapter 2. 
The value is placed there as a two-byte hex number. 


Let’s review that process again: 

1. The address to which the computer is to return in your BASIC program 
is placed on the stack. 


High byte of return address 
Low byte of return address 
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2. The vali 



of variable A is placed on top of the stack. If A = 5, 
i- High byte of A 
s- Low byte of A 
i- High byte of return address 
i- Low byte of return address 


3. The number of variables passed is placed on top of the stack. 



•*- Number of variables passed 
High byte of A 
*• Low byte of A 
*- High byte of return address 
*- Low byte of return address 


Your machine language program may then pull the values off the stack and use 
them. 


PASSING VARIABLES TO MACHINE LANGUAGE SUBROUTINE 

Following is an addition program that will demonstrate this methods. It 
allows you to input a value that is passed to the machine language subroutine. 
The value of five is added to your input by the machine language subroutine. 
The result is placed in memory so that the BASIC program can find it. 

BASIC PROGRAM-ONE VARIABLE PASSED 

100 CLR: DIME$(1), E(10) 

200 FOR Y = 1 TO 10 
210 INPUT N 

220 POKE ADR(E$)+Y,N 

230 NEXTY 

300 GR.O: PRINT “INPUT A” Input a positive decimal integer less 

310 INPUT A than 251 

320 X = USR(ADR(E$)+1,A) Call subroutine 

330 PRINT PEEK(6144) Print sum of your number and 5 

340 END 


Input machine language 
subroutine (10 bytes) 
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When the BASIC program is executed, the value of A will be placed on the 
stack, and your machine language program will pull it off and use it. The result 
will be printed when you come back to your BASIC program. 

The following machine language subroutine shows the contents of the 
accumulator, memory storage location, and stack as the subroutine is executed. 


MACHINE LANGUAGE SUBROUTINE 
Original 
Stack 



E$+8 00 Low byte of memory 
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E$+9 18 High byte of memory 

Memory 1800 Accumulator Stack 



E$+10 60 Return from Subroutine 


USING THE ONE-VARIABLE PROGRAM 

To enter and use the program, follow these steps. 

1. Enter the BASIC PROGRAM-ONE VARIABLE PASSED. 

2. RUN the BASIC program and ENTER these hex codes (one at a time in 
response to the ? prompt). 

^?104 
?24 
?104 
?104 
? 105 
?5 
?141 
?0 
?24 
?96 

3. After the last entry, the screen will clear and the INPUT prompt will 
appear on the screen. 


f INPUT A?" 

Try typing 95 and press the RETURN key. 


f INPUT A?95 



You may try other numbers by typing GOTO 300 in response to the 
READY prompt. This will repeat step 3. Do not type RUN at this time or you 
will have to enter all the hex codes again as in step 2. 
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PASSING MORE THAN ONE VARIABLE 

More than one variable can be passed from your BASIC program to your 
machine language subroutine by the USR function. The next program demon¬ 
strates this. It passes two variables, A and B. These two values are then summed 
by the machine language subroutine. Notice the changes in the BASIC program 
and the subroutine. 


BASIC PROGRAM-TWO VARIABLES PASSED 


100 CLR: DIM E$(1), E(16) 

200 FOR Y = 1 TO 16 
210 INPUT N 

220 POKE ADR(E$)+Y,N 

230 NEXTY 

300 GR.O: PRINT “INPUT A”; 

310 INPUT A 

320 PRINT “INPUT B”; 

330 INPUTB 

340 X=USR(ADR(E$)+1 ,B,A) 
350 PRINT PEEK(6144) 

360 PRINT “PRESS RETURN T 
370 INPUT A$: 

380 GOTO 300 


16 bytes this time 

POKE subroutine 

Two numbers input 

Both A and B put on 
the stack 

REPEAT”; 

Go back to try again 


When line 340 is executed, the USR function causes the stack to be filled 
like this: 


TOP 


2 


ha 

la 

hb 


lb 


yy 


XX 


*■ Number of variables passed 
*• High byte of A 
Low byte of A 
*- High byte of B 
■*- Low byte of B 
<- High byte of return address 
*• Low byte of return address 


BOTTOM 
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Remember, when data items are pulled off the stack, they come off the 
top. The last item put on the stack is the first one taken off the stack. You may 
notice that two bytes are used for each number that was pushed on the stack. 

When a two-byte number is used, one byte is referred to as the Least Sig¬ 
nificant Byte (LSB). The other is referred to as the Most Significant Byte (MSB). 

Example: 

MSB (Most Significant Byte) 



Don’t confuse the Most and Least Significant Bytes with the Most and Least Sig¬ 
nificant Bits. Each byte has an MSB (Most Significant Bit) and a LSB (Least Sig¬ 
nificant Bit). 

MOST SIGNIFICANT BYTE 



most least 

significant significant 

bit bit 


To use a two-byte number, you consider the Most Significant Byte as an exten¬ 
sion of the Least Significant Byte. The place values of the Least Significant were 
assigned powers of two from 0 through 7. 
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_LSB_ 

2 7 2 6 2 s 2 4 2 3 2 2 2 1 2° 
0 1 0 0 0 1 1 0 


= 64+4+2 = 70 (decimal) 


The place values of the Most Significant Byte are assigned the next higher powers 
of two (8 through 15). 


MSB 


2 15 

2 14 2 13 

2 12 2 11 

2 10 2 9 2 8 

1 

0 0 

0 1 

0 0 1 


= 32768+2048+256 = 
35072 (decimal) 


The decimal value resulting from the combined bytes (considered as one num¬ 
ber) is: 


2 is 2 14 2 13 2 12 2 11 2 10 2 9 2 8 2 7 2 6 2 s 2 4 2 3 2 2 2 1 2° 

1 0 0 0 1 00101000110 


In decimal: 32768+2048+256+64+4+2 = 35142 
Split into 4-bit parts: 


HEX digits 8 9 


0100 0110 



This binary value 
is equivalent to 
this hex value 


Hex format: 


MSB LSB 
89 46 


J6 

8 


3 16 2 
9 


16 1 

4 


16 ° 

6 


8*4096 = 32768 
9*256 = 2304 
4* 16 = 64 

6*1 = _ 6 

35142 

(decimal) 


The use of two-byte numbers allows us to use larger inputs (up to 65535). 
However, our machine language program is only designed to add single-byte inte¬ 
gers (0-255). Therefore, the High bytes of the variable A and the variable B are 
both zero. If you input numbers whose sum is larger than 255, you will get an 
incorrect result. 

The machine language program is longer this time, consisting of 16 hex 
codes (16 bytes). 
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MACHINE LANGUAGE SUBROUTINE 


Address 

Hex Code 

Function 

E$+1 

68 

Pull top value off stack and store in accumulator 

E$+2 

18 

Clear the Carry flag to prepare for addition of 
Low bytes of numbers 

E$+3 

68 

Pull High byte of A and put in accumulator 

E$+4 

68 

Pull Low byte of A and put in accumulator 

E$+5 

8D 

Store low byte of A into memory location that 
follows 

E$+6 

01 

Low byte of memory used for storage 

E$+7 

18 

High byte of memory used for storage 

E$+8 

68 

Pull High byte of B and put in accumulator 

E$+9 

68 

Pull Low byte of B and put in accumulator 

E$+10 

6D 

Add with carry the value in the accumulator and 
the value in the memory location that follows 

E$+11 

01 

Low byte of memory 

E$+12 

18 

High byte of memory 

E$+13 

8D 

Store the result in the memory location that 
follows 

E$+14 

00 

Low byte of memory used for storage 

E$+15 

18 

High byte of memory used for storage 

E$+16 

60 

Return from subroutine 

Enter the BASIC program now and RUN it so that you can enter the ma¬ 
chine language codes in the usual way. After the 16 hex codes have been entered, 
the screen clears and you will see the following. 

f 

INPUT A?" 

\Try 135 

[ 

INPUT A?135 
INPUT B?"^^ 

^ Try 99 


INPUT A?135 
INPUT B?99 
234 

PRESS RETURN TO REPEAT?" 
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A new instruction is used at E$+10 of the Two Variable program. It is 
ADC (ADd with Carry) with a hex code of 6D. We used the hex code 69 for 
addition in earlier programs. Why the difference? Well, some of the functions, 
such as addition, can be performed in several modes. This will be more thorough¬ 
ly discussed in Chapter 5. The 69 instruction adds the value immediately follow¬ 
ing it to the value in the accumulator. The 6D instruction adds the value that is 
contained in the memory location that follows the instruction to the value in the 
accumulator. Some instructions can be performed in only one mode, but others 
can be performed in more than one mode. Even though the instruction may per¬ 
form the same function, each mode of the instruction performs the function in a 
different way. Therefore, each mode has a different hex code (called an Opera¬ 
tion Code or Op Code for short) for each mode. 

So far you have only seen machine language routines that proceed straight 
through consecutive memory locations. All of the arithmetic operations were 
performed in the accumulator, called the A register. The 6502 microprocessor 
has other registers which are used in different ways. 

Since the computer is able to perform repetitive operations, such as a 
FOR-NEXT loop, in BASIC, you probably realize that similar operations can be 
done in machine language. In Chapter 1, a brief discussion of the X and Y index 
registers was given. Let’s take a look now at how they can be used. 


A MACHINE LANGUAGE LOOP 


You have no doubt used FOR-NEXT loops many times in BASIC. In the 
next machine language subroutine, we’ll utilize a similar looping technique using 
the X index register as a counter. Here is a comparison of the FOR-NEXT loop 
and a description of a machine language loop that would do about the same 
thing. 


BASIC _ MACHINE LANGUAGE 

Load X register with zero. 

♦Store the value in the X register into memory. 
Increment the X register. 

Compare the X register with 10. 

Branch back if X is not equal to 10. 

Return if X does equal 10. 

The machine language program will be more detailed than the BASIC pro¬ 
gram. Each step must be implemented through exact machine language instruc¬ 
tions. 


FOR X = 0 TO 9 
PRINT X 
NEXT X 
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Here is how the BASIC program and machine language subroutine will be 
accomplished. 


FLOW OF BASIC PROGRAM 



The hex codes for the machine language instructions are given in Appen¬ 
dixes A and B. A more complete description of the instructions can be found in 
the MCS6500 Microcomputer Family Programming Manual.* The instructions 
are listed by their mnemonic codes. The operation codes are given in hexadeci¬ 
mal form. Therefore, you need to convert them to decimal form in order to 
POKE them into memory from your BASIC program. Calculate the decimal 
equivalents for the machine language subroutine that follows. Fill in the blanks 
in the table. 


♦Published by MOS Technology, Inc., 950 Rittenhouse Road, Norristown, PA 19401. 
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MACHINE LANGUAGE SUBROUTINE 


Address Hex Decimal Mnemonic Comments 

Code equivalent code 


E$+1 

E$+2 

E$+3 

E$+4 

E$+5 

E$+6 

E$+7 

E$+8 

E$+9 

E$ + 10 
E$ + 11 

E$+12 
E$ + 13 


68 


PLA 


Pull byte off stack 


A2 

00 


LDX 0 


! 


Load the X register with zero 


8A 

9D 


00 


E8 


E0 


0A 

DO 


F7 

60 


TXA Transfer the value in X register 

to the accumulator 


STA 1800.X 


Store the value in accumulator 
into memory 


INX 

CPX 0A 


BNE F7 


RTS 


Increment the count in the 
X register 


Compare the value in X with 
10 (decimal) 


Branch back if X = 10 (decimal) 
to address E$+4 


Return from Subroutine 


Figure 3-4. Machine Language Exercise 


This subroutine uses several new instructions. 
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NEW INSTRUCTIONS USED 

Six new instructions appeared in the machine language subroutine. At 
E$+2 the hex code A2 was used. This is the operation code for the instruction, 
“Load the X register with the value that follows it.” In our subroutine, we are 
loading the X register with zero. Therefore the instruction at E$+2 and the data 
(0) at E$+3 go together. 

At E$+4, the hex code 8A was used. This is the operation code for the in¬ 
struction, “Transfer the value that is in the X register to the accumulator.” We 
are going to store this value into memory, but to do this we must first place it 
into the accumulator. The accumulator is quite often used as a temporary stor¬ 
age location in passing data from one place in the computer to another. 

At E$+5, the hex code 9D is used. This is the operation code for the in¬ 
struction, “Store the value that is in the accumulator into memory.” This is a 
different mode of the store accumulator instruction. This mode adds together 
the memory location following the instruction to the value contained in the X 
register. The value in the accumulator is stored into this calculated address. The 
X register is used to index the memory location. The same instruction can be 
used several times to store values in different memory locations by changing the 
value in the X register. 

At E$+8, the hex code E8 is used. This is the operation code for the in¬ 
struction, “Increment the value that is in the X register.” The value is increased 
(incremented) by one. Thus, each time the computer passes through the loop, a 
new memory location will be used in the instruction at E$+5. 

AT E$+9, the hex code E0 is used. This is the operation code for the in¬ 
struction, “Compare the value that is in the X register to the value that follows 
the E0 operation code.” The value 0A (10 decimal) follows this instruction. 
Thus the value in the X register is compared with 0A (hex). This supplies the 
computer with a condition (X=0A or X^OA) so that it can make a branching de¬ 
cision at the next instruction. 

At E$+11, the hex code DO is used. This is the Operation Code for the in¬ 
struction, “Branch if the previous condition is not equal.” Otherwise go on to 
the next sequential instruction. For values of X less than 0A, the computer will 
branch back to the instruction at location E$+4. When X reaches 0A, the com¬ 
puter will go on to the instruction at E$+13. The computer goes through this 
loop 10 times (for X values of 0 through 9) and then returns to the main pro¬ 
gram. The value F7 used at location E$+12 is a signed hexadecimal equivalent of 
the decimal value -9. In other words, the computer must branch back nine steps 
if the given condition is true (Xf 0A). The size and direction of branches will be 
discussed in Chapter 5. 

We’ll trace through the machine language subroutine step by step later in 
this chapter, but let’s first take a look at the BASIC program which loads, calls, 
and prints out the results of the machine language subroutine. 
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BASIC PROGRAM 


100 REM INITIALIZE MEMORY 
110 CLR:DIM E$(1), E(13) 

120 REM ENTER MACHINE CODES 
130 FOR N = 1 TO 13 

140 READC +- Read codes from DATA 

150 POKE ADR(E$)+N,C «- Place in subroutine 

160 NEXT N 

170 REM CALL SUBROUTINE 
180 X=USR(ADR(E$)+1) 

190 REM PRINT RESULTS 
200 GR.O 
210 FOR N = 0 TO 9 
220 PRINT PEEK(6144+N) 

230 NEXT N 
240 END 

250 REM DECIMAL DATA 
260 DATA 104,162, 0,138,157,0, 24, 232, 22 
4,10,208,247,96 

^ Machine codes in decimal form 
(from Figure 3-4) 


<- Clear screen 

+- Print the counts used 
for machine language loop 


The FOR-NEXT loop at lines 130 through 160 READs in the decimal 
equivalents of the hex codes and POKEs them into the correct memory locations 
for the machine language subroutine. Remember, that even though BASIC needs 
the data in decimal form, the codes will be inserted into memory in binary form. 
The first few bytes of the program will actually be stored like this: 


E$+1 

| 0 1 1 

0 1 

0 0 

3 

= 64+32+8 = 104 decimal 


6 


8 


+- hex code 

E$+2 

| 1 0 1 

0 0 

0 1 

3 

= 128+32+2 = 162 decimal 


A 


2 


+- hex code 

E$+3 

0 0 0 

0 0 

0 0 

3 

= 0 decimal 


hex code 
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TRACING THROUGH THE SUBROUTINE 


The best way to understand a program is to put yourself in the place of 
the computer and perform each instruction as it occurs in the program. Let’s 
now trace through the operations performed by the computer in our subroutine. 
To do this, we will have to keep track of what is happening in register X, the 
accumulator, and in the memory storage locations. We might also show what is 
contained on the stack. 

As the machine language subroutine is called, the stack contains: 


Number of variables passed 
■<- Return address 


When the first machine language program is executed, the stack changes. 


00 


yy 


Address Instruction 

E$+1 Pull byte off stack 



Return address 


Only the return address remains. Now, the rest of the subroutine. 


Address Instruction X Accumulator Memory 


E$+2 Load X 

E$+3 with zero 

E$+4 Transfer X to A 

E$+5 Store accumulator 

E$+6 in (1800+X) 

E$+7 

E$+8 Increment X 

E$+9 Compare X 

E$+10 with 0A 



E$+11 Branch back to 
E$+12 E$+4 if X ^0A 

E$+4 Transfer X to A 


0 

0 0 

0 0 1800->■ [o] 

1 0 

1 0 

1 1 
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Address 

Instruction 


Accumulator Memory 

E$+5 

Store Accumulator 

1 

1 1801 -+ [ 7 ] 

E$+6 

in (1800+X) 


E$+7 




E$+8 

Increment X 

2 

1 

E$+9 

Compare X 

2 

1 

E$+10 

with 0A 




(jX=2, not 0A)^ 



E$+11 

Branch back to 

2 

1 

E$+12 

E$+4ifX)tOA) 



E$+4 

Transfer X to A 

2 

2 

E$+5 

Store Accumulator 

2 

2 1802-+ [ 7 ] 

E$+6 

in (1800+X) 


E$+7 




E$+8 

Increment X 

3 

2 

E$+9 

Compare X 

3 

2 

E$+10 

with 0A 




(jX=3, not 0A)) 



E$+11 

Branch back to 

3 

2 

E$+12 

E$+4 if X^OA 



E$+4 

Transfer X to A 

3 

3 

E$+5 

Store Accumulator 

3 

3 1803 -+ [ 7 ] 

E$+6 

in (1800+X) 



E$+7 


This process continues with the value in X being increased by one. That 
value is transferred to the accumulator and then put into the memory location 
whose address is 1800+X. 

The X register is used as a counter for the loop and also to index the mem¬ 
ory storage (store into successive memory locations from 1800 upwards). We 
continue the trace after X has been incremented to 9 and the branch has been 
taken back to E$+4. 
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Address 

Instruction 

X 

Accumulator 

Memory 

E$+4 

Transfer X to A 

9 

9 


E$+5 

E$+6 

E$+7 

Store Accumulator 
in (1800+X) 

9 

9 

1800 -»| 9 | 

E$+8 

Increment X 

A 

9 


E$+9 

E$+10 

Compare X 
with 0A 

((X=0A, at last) 

A 

9 


E$+11 
E$+12 

E$+13 

Branch back to 
toE$+4ifX^0A 

Return from Subroutine 

A 

9 



The return address is taken from the stack. The stack is now empty. 

Thus, when the subroutine is completed, the values assigned to the X regis¬ 
ter (0 through 9) have been stored into memory. 


DATA STORED BY SUBROUTINE 


Hex Decimal Value 

Address Address Stored 


1800 6144 0 

1801 6145 1 

1802 6146 2 

1803 6147 3 

1804 6148 4 

1805 6149 5 

1806 6150 6 

1807 6151 7 

1808 6152 8 

1809 6153 9 


Notice that the last value placed in the X register (0A) was not saved in 
memory. 

When the subroutine returns to the BASIC program the values stored in 
the above memory locations are printed out on the screen. 
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SUMMARY 


In this chapter, you have learned: 

• How to convert a hexadecimal number to its decimal equivalent; 

• How memory is allocated in the Atari computer; 

• How to set aside memory locations for a machine language subroutine; 

• How to use the X index register to count the number of times that a 
loop is executed in a machine language program; 

• How to test the X register to determine when to exit a loop; 

• How to trace a machine language program by performing the instruc¬ 
tions yourself; 

• That some instructions can be used in more than one way (more than 
one mode); 

• That the USR function can pass values from your BASIC program to 
your machine language program; 


1080 A=5: B=6 

1090 X=USR(ADR(E$)+1 ,A,B 


• That numbers passed by the USR function are pushed onto the stack as 
two-byte numbers; 

• The following new machine language instructions: 


A2 LDX Load the X register with the value that follows. 

8A TXA Transfer the value in the X register to the accu¬ 

mulator. 
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9D 


E8 

EO 

DO 


STA Store the accumulator’s contents into the mem¬ 
ory location that follows, indexed by the X 
register. 

INX Increment the value in the X register. 

CPX Compare the value in the X register to the value 
that follows. 

BNE Branch forward, or back, the number of steps 
given if condition is not equal to zero. 


EXERCISES 

1. Convert the following hexadecimal numbers to their decimal equivalents. 

A2 hex = _ decimal 

3B hex = _ decimal 

9E hex = _ decimal 


work space 


2. It is not safe (or at least caution must be used) to POKE- 

BASIC, machine 

language instructions in the area of memory below your- 

BASIC, machine 

language program instructions. 

3. If your BASIC program dimensions the string variable E$ to one, you are 

saving space in the memory area above your BASIC program. At what 
address would it be safe to start a machine language program called from 
your BASIC program? _ 

4. Does the location saved for E$ depend upon the length of your BASIC 

program? _ 

5. Data assigned to variables can be passed from a BASIC program to a ma¬ 
chine language subroutine. Even though no variables are passed to the sub- 
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routine, the subroutine must perform some operation on the stack before a 
return can be made from the subroutine. What is that operation? 


6. Suppose that the X register contains the value 7, and the accumulator holds 
the value 1 A. The computer executes the instruction: 

E$+7 9D ST A 1800, X 

E$+8 00 

E$+9 18 

In what memory location is the value 1A stored? 

7. The BASIC program of page 44 and the subroutine of page 42 are to be 
executed. The only change made is to line 210 of the BASIC program. It is 
changed to: 

210 FOR N = 3 TO 5 

Show what will be printed on the screen when the program is executed. 

I *- Answer here 


8. What changes would be made to the machine language subroutine on page 
42 if you wanted the loop to count to 20 decimal instead of 10 decimal? 

address hex code 

9. What changes would you make to the BASIC program on page 44 to print 
out the 20 values stored by the changed machine language program (exer¬ 
cise 8)? 

260 DATA _ 


ANSWERS 

1. A2 hex = 162 decimal 
3B hex = 59 decimal 
9E hex = 158 decimal 

2. Machine 
BASIC 

3. E$+1 or ADR(E$)+1 

4. Yes (Space is saved for E$ at the end of your BASIC program.) 
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5. One byte must be pulled off the top of the stack (the number that tells how 
many variables were passed, zero in this case) before the return address is 
available. 

6. Location 1807 (1800+7) 

^-the value in X 




Chapter 4 


Getting Started 
With the Assembler 


Only the 400 or 800 computer and the Assembler Cartridge are necessary 
to write, assemble, and execute assembly language programs. However, some stor¬ 
age device (an Atari 410 Program Recorder or Atari 810 Disk Drive) is recom¬ 
mended. Otherwise, you will have to enter your program from the keyboard 
each time that you want to use it. The Atari 820 printer is an optional addition. 
It will allow you to make permanent records of your programs in a form that is 
easy to read. 

In writing this book, the authors used the system elements shown below in 
solid lines. Those elements in broken lines are optional. 



Figure 4-1. Our A tari 800 System 


Communication between elements of the Atari 400/800 system is man¬ 
aged by the Atari Operating System contained in a 10K ROM (10,000-byte Read 
Only Memory) using some associated RAM (Random Access Memory). The 
Assembler taps into the Operating System as needed. 

The Atari Assembler Cartridge contains three separate programs: 

1. The Writer/Editor 

2. The Assembler 

3. The Debugger 

The Writer/Editor Program, just as the name implies, is used to write and 
edit your assembly language programs. Assembly language is a shorthand that 
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uses English like abbreviations to represent instructions to the computer. It also 
uses numbers in decimal or hexadecimal form to provide data for the programs. 

The Assembler Program translates the abbreviations provided by the Writer/ 
Editor into machine language codes and data that the computer can understand. 
It also takes care of assigning the instructions and data to their proper memory 
locations. 

The Debugger Program is used to execute, test, or trace the operation of 
the machine language program that the Assembler produced. 

You can see that the three programs are used in a logical order. If the De¬ 
bugger produces a faulty program, you may return to the Writer/Editor Program 
for changes. The process is then repeated until satisfactory results are obtained. 
Here is a diagram of the order in which the three programs are used. 



Figure 4-2. Use Flow of Assembler Cartridge 

THE WRITER/EDITOR 

Before we get too involved in the technicalities of assembly and machine 
language, let’s power up the computer and try a short sample program. 

Place the Assembler Cartridge in the left slot of the computer, make sure 
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that your TV set is connected and turned on, and turn on the computer. This is 
what you should see on the screen: 

f EDIT +- This message tells you the Writer/Editor 

Program is being used. 

Cursor indicates that it’s your turn to type. 

A small amount of memory space (108 locations) is used to store the char¬ 
acters typed in for the line that you are currently typing. This area or memory is 
called the Current Line Buffer. The buffer is written over as each new line is 
typed in. It is located in an area of 384 locations (180 HEX) which is reserved 
for the Assembler Cartridge. 

An area of memory just above that saved for the Assembler is used for the 
Edit Text Buffer. It stores all the input from the keyboard as you are writing the 
Assembly Language Program. As you enter more and more from the keyboard, 
the Edit Text Buffer fills up. No upper bound is specified. However, it is possible 
to exceed the memory limits of your computer. 



End of —► 
8 K memory 


ICIF 

(Hex) 


0880 


(Hex) 

0700 


(Hex) 


| Edit text buffer 
\ Assembler cartridge and 
J current line buffer 


Figure 4-3. Buffer Memory 

To find the location of the Current Line Buffer and the Edit Text Buffer, 
type the command: 


SIZE (and press the RETURN key) 



Memory location 
of Current Line. 
Buffer 


0880 1C1F 


t 

The memory address 
of the location where 
the next character 
typed will appear (in¬ 
creases as you type) 


t 

The highest 
memory loca¬ 
tion available 
in your com¬ 
puter 
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The numbers displayed will differ according to the amount of memory in 
your system. Remember, our system is the Atari 800 with 8K or RAM and no 
disk. 

You can find out, at any time, how long your program is by using the 
SIZE command. Subtract the first number (700 in our case) + 180 from the sec¬ 
ond number. The result is the approximate number of characters in your program. 

Before we enter our program, let’s take a look at the format used for writ¬ 
ing assembly language programs. The program to be assembled is called a Source 
Program. The Source Program consists of statements just as a BASIC program 
does. The statements are numbered just as BASIC lines are numbered. Every 
statement must start with a line number in the range of 0 through 65535. After 
each statement is entered using the Writer/Editor Program of the Assembler 
Cartridge, it is terminated (or entered) by pressing the RETURN key. 

The format used for each statement is divided into five fields. 



Examples: 

1. No label used 
20 


CLC 


/ t t 

Statement Op Code 
Number | 

No label—so 
two spaces 


| This instruction—Clear the Carry bit | 


2 . 


No label used 

30 LDA 



Statement 

Number 


t 

Op Code 


No label—so 
two spaces 


#0 

t 

Operand 

(In Immediate Addressing Mode—#) 


This instruction—Put zero in the accumulator 
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40 


/ 

Statement 
Number 

Label used— 
so one space 


LOOP ADC #1 


t t X 

Label Op Code Operand 

(In Immediate mode) 


| This instruction-Add one to the value in accumulator | 

4. No label used 

50 CMP #3 

/ t t \ 

Statement Op Code Operand 
Number | (In Immediate mode) 

No label— 
so 2 spaces 


This instruction—Compare the value in accumulator with 3 


5. No label—operand gives branch location 


//° 

Statement 

Number 


BNE LOOP 

i t 

Op Code Operand 

(a label this time) 


No label— 
so 2 spaces 


This instruction—If the 2 values are not equal, go back to the instruction 
with the LOOP label 


Now, let’s write an assembly language program using the above statements. 
When we left the computer, it was in the Edit mode. 

'edit 

SIZE 

0700 0800 1C1F 

EDIT 

■ 

We must first tell the assembler where to start our machine language pro¬ 
gram, called the Object Program, in memory. We do this with a special command. 
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The starting memory location of the machine language program must be high 
enough above the Edit Text Buffer (0880 in our case) so that the two programs 
do not overlap. 

Type: 10 *=$1000 

t \ 

Line 2 spaces Starting address ($ indicates a hexadecimal value) 
number 

Then the balance of the program is entered. Remember to press the RETURN 
key at the end of each line (just like you do in BASIC). 

20 CLC 

30 LDA #0 

40 LOOP ADC #1 

50 CMP #3 

60 BNE LOOP 

The program must conclude with an END statement (called a PSEUDO OPERA¬ 
TOR or Directive ). Every program should have one and only one END Directive. 

70 END 

t 

one space 

THE ASSEMBLER PROGRAM 

After the program has been entered using the Writer/Editor Program, the 
next step is performed by the Assembler Program. The assembler will convert 
the assembly language instructions to machine language codes and assign mem¬ 
ory locations to the machine language codes. 

The video screen at this time (before going to the Assembler Program) 
shows: 


^EDIT 

10 *=$1000 
20 CLC 
30 LDA #0 
40 LOOP ADC #1 
50 CMP #3 

60 BNE LOOP 

70 END 

Let’s check to see how much memory has been used by our assembly lan¬ 
guage program. Remember, when we typed SIZE earlier, we saw: 
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1C1F 

To see how much memory has been used, once again type: SIZE. 


1C1F 


New value 

Our program has used 8D4-880 or 54 (hex) memory locations: 

«- 1 Cl F Top of our memory 
■«-? End of machine language program 
■*- 1000 Start of machine language program 
■*- 08D4 Top of Edit Text Buffer 
■*- 0880 Beginning Edit Text Buffer 

Notice that there is an unused area between the assembly language pro¬ 
gram (Edit Text Buffer) and the machine language program. That is good. When 
longer assembly language programs are used, care must be taken that machine 
language and assembly language programs do not overlap. We can now proceed 
to the Assembler Program. 

You now type: ASM (and press the RETURN key) 

Each machine code is displayed followed by the assembly language instruc¬ 
tions that created it. 


60 END 
ASM 

0000 10 *= $1000 

1000 18 20 CLC 

1001 A900 30 LDA #0 





1003 6901 


40 LOOP 


ADC #1 
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1005 C903 50 CMP #3 


1007 DOFA 60 BNE LOOP 



The assembler created Assembly language 

this machine language (Source Program) 

program. 

(Object Program) 

The assembly language Source Program that you entered is shown on the 
right side of the screen. The machine language Object Program that the assembler 
produced is shown on the left side of the screen with the memory locations that 
were assigned to each machine language instruction. Let’s examine the programs 
line by line to see how the instructions match up. 


Machine Language 


Assembly Language 


ASM 

0000 

1000 


10 *= $1000 
Line 10 assigned the starting address of the ma¬ 
chine language program to 1000 (hex). 


18 


20 CLC 


The instruction CLC is assembled into the ma¬ 
chine language code: 18. The instruction 18 is 
placed in memory location 1000. 


1001 A900 30 LDA #0 

The instruction LDA #0 is assembled into the 
machine language code: A900. The instruction 
A9 (from LDA #) is placed in memory location 

1001, and the data (00) is placed in location 

1002. 


1003 6901 40 LOOP ADC#1 

The instruction ADC #1 is assembled into the 
machine language code: 6901. The instruction 
69 (from ADC #) is placed in memory location 
1003, and the data (01) in location 1004. 
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1005 C903 50 CMP #3 

The instruction CMP #3 is assembled into the 
machine language code: C903. The instruction 
C9 (from CMP #) is placed in memory location 
1005, and the data (03) in location 1006. 

1007 DOF A 60 BN E LOOP 

The instruction BNE LOOP is assembled into 
the machine language code: D0FA. The instruc¬ 
tion DO (from BNE) is placed in location 1007, 
and the length of the branch (FA) is placed in 
location 1008. The branch if taken goes back to 
memory location 1003 where the LOOP began. 

70 END 

Line 70 tells the assembler where to stop. No 
machine code is created. 

We have used five assembly language instructions in this program. These in¬ 
structions consist of a mnemonic code that is an abbreviation of its English lan¬ 
guage meaning and usually an operand. These meanings are given below. 


Mnemonic Operand 


Meaning 


CLC 


LDA 


CLear the Carry bit of the Processor Status 
Register (set it to zero). 


_0 

^arry 


11111110 


LoaD Accumulator with the immediate oper¬ 
and (#0) 



ADC 


#1 


ADd to accumulator with Carry the immediate 
operand (#1). 
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Add 1 


CMP #3 = CoMPare the value in accumulator with the im¬ 

mediate operand (#3) 



BNE LOOP = Branch on result Not Equal to the instruction 

with a label of LOOP 

_ 4 _ 


^ Is Accumulator = 3? J 



The machine language program has been assembled and is stored in the 
computer’s memory as follows: 


Memory 

Location 

Machine 

Code 



1000 

18 

Instruction CLC 


1001 

A9 

Instruction LDA # 


1002 

00 

Data loaded 


1003 

69 

Instruction ADC # 


1004 

01 

Data to be added 


1005 

C9 

Instruction CMP # 


1006 

03 

Data to be compared 


1007 

DO 

Instruction BNE 


1008 

FA 

Data telling where to branch 


Figure 4-4. Machine Language Program Storage 
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EXECUTING THE MACHINE LANGUAGE PROGRAM¬ 
ME DEBUGGER 

You have used the Writer/Editor Program to write the assembly language 
program and the Assembler Program to assemble it into machine language codes 
and allocate memory locations. It’s now time to use the Debugger Program to 
execute (or run) the machine language program. 

After the program was assembled, you probably noticed that the computer 
returned to the Writer/Editor Program and displayed the word EDIT followed 
on the next line by the cursor. 


EDIT 


You enter the Debugger 
Program by typing: BUG - 


The computer responds: - 


EDIT 

BUG 






The computer is now waiting for a DEBUGGER command. There are sev¬ 
eral, but we’ll only look at two of them right now to avoid confusion. The first 
has the form: 


G for GOTO 


XXXX represents the hexadecimal digits of the memory 
location of the beginning of our program 


If you type: G1000 (and press the RETURN key), the program will exe¬ 
cute immediately. You will see the following on the display: 
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r~ 


EDIT 

BUG 


DEBUG 

G1000 

1009 

DEBUG 


You typed this 


A=03 X=00 Y=00 P=33 S=00 


Computer 

responds 


What does all this mean? 


1. The number 1009 tells you that the program stopped at this memory 
location. It executed all the instructions from location 1000 through 
1008. 


2. The only other value on the line that we are presently concerned with 
is: A=03. A stands for Accumulator. The value 03 shows that the accu¬ 
mulator holds a value of 3 when the program ended. This is just what 
we wanted. Our program put an original value of 0 in the accumulator 
(LDA #0). It then added a 1 each time through the loop until the accu¬ 
mulator contained a value of 3. Then the computer stopped. 


Let’s watch it count, step by step, as the program is executed. Notice that 
the DEBUG message was displayed at the end of the previous program execution. 
This means that we are still in the Debugger Program and can try out our second 
DEBUGGER command. We can perform a step-by-step trace of the program by 
typing: 


T for TRACE 


(and press return) 
Starting memory location 1000 


This is what we then see on the display: 
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1000 18 CLC 1 I The top two lines will I 

A=00 X=00 Y=00 P=32 S=00 ’ ' scroll off the screen I 

1001 A9 00 LDA #$00 

A=00 X=00 Y=00 P=32 S=00 

1003 69 01 ADC #$01 <- One added to accumulator 

A=01 X=00 Y=00 P=30 S=00 
1005 C9 03 CMP #$03 

A=01 X=00 Y=00 P=B0 S=00 
1007 DO FA BNE $1003 

A=01 X=00 Y=00 P=B0 S=00 

1003 69 01 ADC #$01 <- Branch back and add 1 more 

A=02 X=00 Y=00 P=30 S=00 
1005 C9 03 CMP #$03 

A=02 X=00 Y=00 P=B0 S=00 
1007 DO FA BNE $1003 

A=02 X=00 Y=00 P=B0 S=00 

1003 69 01 ADC #$01 ■*- Branch back and add 1 more 

A=03 X=00 Y=00 P=30 S=00 
1005 C9 03 CMP #$03 

A=03 X=00 Y=00 P=33 S=00 ^^Now comparison is equal- 
1007 DO FA BNE $1003 so no branch 

A=03 X=00 Y=00 P=33 S=00 / 

1009 00 BRK BRK for break-program 

A=03 X=00 Y=00 P=33 S=00 stops 

DEBUG 


Figure 4-5. Program Trace 

Notice that the Accumulator (A) increases by one each time the ADC #01 
instruction is executed at location 1003. The value in the accumulator is shown 
following each instruction line as: A=nn (where nn is a two-digit hex value). The 
values that you see in the other registers may differ from that shown here. Do 
not worry about them for the time being. You should only be concerned with 
the accumulator at this time. Registers are covered in Chapter 5. 

If you want to see how fast the computer can count to 255 (FF HEX), 
let’s modify the compare value at line 50 to: 


The $ denotes a hex number (when not used, a 
decimal value is assumed.) 


With this modification, the computer will not stop when the value in the accu¬ 
mulator equals 3 but will go right on to FF. We could enter a whole new pro- 
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gram to accomplish this change, but it’s easier to alter the program that we 
already have. 

We left the computer in the Debugger Program after tracing our last pro¬ 
gram. We need to get back to the Writer/Editor Program to change line 50. 


Type : X (and press RETURN) 



To take a look at the previous Assembler Program, guess what command 
is used. 


Type: LIST (and press RETURN) 



All that you have to do to change line 50 is to type in the new line (with 
the line number of course). 


Type: 50 


CMP #$FF 


(Don’t forget the $ sign.) 
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r~ 


70 END 
50 CMP #$FF 


To verify that the change has been made, LIST the program again. 


70 END 
50 CMP #$FF 
LIST 

10 *=$1000 
20 CLC 
30 LDA #0 
40 LOOP ADC #1 

50 CMP#$FF^. ■*- Yes, the change was made. 

60 BNE LOOP 
70 END 


Another way to replace the value to be compared would be by the Editor’s 
REPLACE statement. We could have accessed the Edit mode and typed: 


Replace 



the new 
value 


three backslashes 


The result would have been the same. 

Even though the change has been made to the assembly language program, 
it has not been made to the machine language program. We must assemble the 
modified program. 
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Type: ASM (and press RETURN) 


60 END 
ASM 


0000 


10 

*= 

$1000 

1000 

18 

20 

CLC 


1001 

A900 

30 

LDA 

#0 

1003 

6901 

40 LOOP 

ADC 

#1 

1005 

C9FF 

50 

CMP 

#$FF 

1007 

D0FA 

60 

BNE 

LOOP 


70 END 


EDIT 

■ 

Remember, we must use the Debugger Program to execute the program. 
So type: BUG 


EDIT 

BUG 

DEBUG 


Now run the program by typing: G1000 


'debug 

G1000 

1009 

DEBUG 


A=FF X=00 Y=00 P=33 S=00 


Wow, that was quick! How do we know the computer didn’t just print the 
final result instead of counting all the way? Let’s slow it down by tracing the 
program. 

Keep your eye on the column that prints the value in the accumulator (A). 
The results will go by pretty fast as the screen fills up and scrolls upward. It will 
take between 2 and 3 minutes for the accumulator to reach FF. 
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Type: T1000 (and press RETURN) 

The screen scrolls merrily on its way. After some time it finally stops at 
the end of the program. 


1007 DO FA BNE $1003 

A=FF X=00 Y=00 P=33 S=00 
1009 00 BRK 

A=FF X=00 Y=00 P=33 S=00 
DEBUG ! 

Yes, it really did count up to FF. 

It did take awhile for the computer to trace through the program. That’s 
because it had to look up and print out all those values in the registers. It works 
much faster when you leave it alone and don’t ask it to perform any extra tasks. 

We have found out that we can increase the value in the accumulator by 
adding one to it. We can also subtract values from the accumulator. Why not 
start with a value of FF and subtract one from it each time through the loop? To 
do this we need two new instructions. 

SBC (SuBtract from accumulator with borrow; borrow is the opposite of Carry, 
but they call it SBC) 

SEC (set the Carry bit. This will replace the Clear Carry instruction.) 

We can use our old program to model the new one. 



ADD PROGRAM 


SUBTRACT PROGRAM 

10 

*=$1000 


10 

*=$1000 

20 

CLC *- 

Clear and set -» 

20 

SEC 

30 

LDA #0 «- 

Start at -* 

30 

LDA #$FF 

40 

LOOP ADC #1 <- 

Add and Subtract -»• 

40 

LOOP SBC #1 

50 

CMP #$FF <- 

Go until -*■ 

50 

CMP #0 

60 

BNE LOOP 


60 

BNE LOOP 

70 

END 


70 

END 


If you still have the Add Program in memory (check by entering the Writer/ 
Editor Program and LISTing the program), you can change lines 20, 30,40, and 
50. Then assemble the new program. Otherwise, enter the complete new Sub¬ 
tract Program, and then assemble it. 

After assembling the new program, enter the Debugger Program and exe¬ 
cute it by typing: 
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G1000 



You can verify the action by using the trace feature. Use the BREAK key 
to stop the program at a convenient point. As shown by the following display, 
we stopped ours shortly after it started. 


Type: T1000 



Accumulator down from FF to FD 


If you let the program execute until the accumulator counts down to zero, 
you’ll find out that the computer can count backwards just as fast as forwards. 
Keep your eye on the Accumulator as the data scrolls by. 

Let’s take a break now to sum up what you have learned so far. Several 
small doses of assembly language are easier to take than a few very large ones. A 
more complete coverage of the Assembler features is summarized in Chapter 7. 
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SUMMARY 

The Assembler Cartridge consists of 3 programs: 

1. Writer/Editor—Used to write and edit assembly language programs. 

2. Assembler-Used to translate assembly instructions into machine code 
and to assign memory locations for the machine language program. 

3. Debugger—Used to execute machine language programs. 

Key Words Used 

Writer/Editor 

1. EDIT—a prompt to let you know you are in the Writer/Editor Program. 

2. SIZE-Displays memory locations of Current Line Buffer, Edit Text 
Buffer, and your machine’s highest available memory. 

3. LIST-Lists the assembly language program on the video screen. 

4. BUG—A command that transfers control from the Writer/Editor Pro¬ 
gram to the Debugger Program. 

5. ASM—A command that transfers control from the Writer/Editor Pro¬ 
gram to the Assembler Program. 

Debugger 

1. DEBUG—A prompt to let you know that you are in the Debugger Pro¬ 
gram. 

2. GXXXX—A command which executes the current machine language 
program beginning at memory location XXXX (each X is a hex digit). 

3. TXXXX—A command to trace each step of the current machine lan¬ 
guage program as it is executing from memory location XXXX (each X is again 
a hex digit). 

4. X-A command that transfers control from the Debugger Program to 
the Writer/Editor Program. 


Instructions Used: 


Assembly Language 

Machine Language 

Comments 

Instructions 

Code Produced 


(for Source Program,) 

(for Object Program) 


LDA#0 

A9 00 

Load accumulator with zero- 
immediate Addressing mode 

ADC #1 

69 01 

Add 1 to the accumulator- 
immediate Addressing mode 

CMP #3 

C9 03 

Compare value in accumulator 
with 3—Immediate Addressing 
mode 
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BNE LOOP 


END 
SBC #1 

CLC 

SEC 


DO FA Branch on result not equal to 

zero back to the instruction 
labeled LOOP—Relative Ad¬ 
dressing mode 

A Directive—no machine code 
is generated. 

E9 01 Subtract 1 from the value in 

the accumulator—Immediate 
Addressing mode. 

18 Clear the Carry bit 

38 Set the Carry bit to 1 


EXERCISES 


1. Assembly language programs are written using the_ 

Program of the Assembler Cartridge. 

2. The_Program of the Assembler Cartridge is 

used to translate assembler language programs to machine code. 

3. Machine language programs are executed from the _ 

Program of the Assembler Cartridge. 

4. The Source Program is assembled into the _ Program. 

5. The function of LDA #0 is to load the accumulator with zero. Give 
the function of the following assembly language instructions. 

(a) LDA #$FF _ 

(b) ADC #10 _ 

(c) CMP #$1 E_ 

Exercises 6 through 10 refer to this assembled program. 


'asm 

0000 

1000 18 

1001 A9 01 

1003 69 02 

1005 C9 03 

1007 DO FA 


10 *= $1000 

20 CLC 

30 LDA #1 

40 LOOP ADC #2 
50 CMP #9 

60 BNE LOOP 

70 END 


Machine language 
program 


Assembly language 
program 
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6. The accumulator is first loaded with what number? _ 

7. What number is added each time through the loop? _ 

8. What will be the number in the accumulator when the program has 

passed through the loop the last time?_ 

9. If a trace of the machine language program was executed, the trace 

would display accumulator values that are _ from__ 

(odd, even) 

through _ . 

10. Lines 30 and 50 in the assembly language program could be changec 
so that the display of a trace would display accumulator values that 
were even from 0 through 8. Show the two modified assembly lan¬ 
guage lines that would make this change. 

30 _ 

50 _ 


ANSWERS 

1. Writer/Editor 

2. Assembler 

3. Debugger 

4. Object 

5. (a) Load the accumulator with FF (hex) 

(b) Add 10 to the accumulator (10 is decimal—no $ sign) 

(c) Compare the value in the accumulator with 1E (hex) 

6 . 1 

7. 2 

8. 9 

9. odd, 1,9 

10. 30 LDA #0 

50 CMP #8 
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Special-Purpose Registers 
and Addressing Modes 


The 6502 microprocessor used in the Atari 400/800 computers has several 
special-purpose registers. These registers hold 8 bits (1 byte) of data just like 
memory locations but are used for special purposes. You have seen displays of 
the data contained in these registers in the trace of the program in Chapter 4. 

Example: 

1004 C9 03 CMP #03 

A-03 X=00 Y=00 P=33 S=00 

^/ / t \ 

Accumulator X register Y register Processor Stack 

Status Pointer 

Register Register 

We will discuss these special registers in the order listed below. 

1. The Accumulator—Most operations on data are performed here. You 
can tell from the short program in Chapter 4 that the accumulator is a very busy 
place. 

2. The X register—This register is used as a scratch pad or as an index in 
certain addressing modes. 

3. The Y register—This register is used in the same way as the X register. 

4. The Processor Status Register-This register contains a record of the 
microprocessor’s status as each instruction is executed. Each bit of this register 
holds one item of status information. 

5. The Stack Pointer Register-The data in this register is the memory loca¬ 
tion of the top of the stack. The stack is a special block of memory at addresses 
01FF down through 0100 (hex). 
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THE ACCUMULATOR 

The programs in Chapters 3 and 4 showed how the accumulator can be 
loaded with a number in the Immediate Addressing mode. One program also 
added a number to this value (using the Immediate Addressing mode) and then 
compared the result with the value 3 (again in the Immediate Addressing mode). 
All of those operations were performed using only the accumulator and data 
held in certain memory locations of the program. 

A branch instruction (BNE in the Relative Addressing mode) was also 
used in the program. To determine whether to take the branch or not, the com¬ 
puter examined the Processor Status Register. It looked at one bit (the zero bit) 
of the Processor Status register. 

THE X AND Y REGISTERS 

Let’s now develop a short program to demonstrate some action taking 
place in the X register. It will be very similar to the programs used in Chapters 
3 and 4. 

1. LDX #0 Load the X register (LDX) with zero using the Immediate 
Addressing mode (#0). 

2. INX Increment the X register (INX) using the Implied Addressing 
mode (no operand used). 

3. CPX #3 Compare the value in the X register (CPX) with 3 using the 
Immediate Addressing mode (#3). 

4. BNE LOOP Branch if the result (X register-3) is not equal to zero 
(BNE) back to the instruction that you have labeled LOOP (INX in this program). 

The program is written using the Writer/Editor Program of the Assembler 
cartridge as before. When you are in the Edit mode, type NEW to erase any old 
program that may still be in the Edit Buffer. This does not erase the memory 
contents (the previously assembled machine language program). Enter the 
program as shown. 

'EDIT 

10 *=$1000 
20 LDX #0 

30 LOOP INX 

40 CPX #3 

50 BNE LOOP 

60 END 



You enter this. 
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Then you use the Assembler Program to assemble the machine language 
program. 



Now enter the Debugger Program and execute the run. 
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This time, trace the program step by step. Type: T1000 



Notice that the value in the X register increases each time that the compu¬ 
ter executes I NX at location 1002. Notice also that the program stops at loca¬ 
tion 1007 with the instruction BRK (BREAK). 

The computer uses the BREAK instruction to stop itself at the end of a 
program. We’ll discuss the BRK instruction more thoroughly in Chapter 9. 

Next, let’s modify the program to count in both the accumulator and the 
X register. We’ll use one new instruction: 

TAX 


No, it’s not really tax time. This is just a mnemonic code that stands for: 
Transfer Accumulator to X register. When this instruction is executed, the data 
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currently in the accumulator is transferred to (or copied into) the X register. The 
data also stays in the accumulator. 



X Register 


Copy accumulator into X register (TAX) 


Type: X and press the RETURN key to get back to the Writer/Editor 
mode. Now you can erase the old program by typing: 


NEW 


Wow! This is just like BASIC. The old program is erased and you are ready 
to write the new program. 


PROGRAM TO COUNT IN ACCUMULATOR 
AND IN THE X REGISTER 


^EDIT 

10 *=$1000 
20 CLC 
30 LDA #0 
40 TAX 
50 LOOP ADC #1 
60 INX 
70 CPX #3 
80 BNE LOOP 
90 END 


New Instruction, Transfer 
content of Accumulator to 
the X register 
Add 1 to accumulator 
Increment X register 
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Then assemble it: 



Now enter the Debugger Program. 



To see what happens as a program is executed, the trace feature of the 
assembler is a tremendous aid. Let’s use it again to watch our program in action. 
Type: T1000 and press the RETURN key 
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1007 E0 03 
A=01 X=01 Y=00 P=B0 S=00 
1009 DO F9 
A=01 X=01 Y=00 P=B0 S=00 
1004 69 01 

A=02 X=01 Y=00 P=30 S=00 

1006 E8 

A=02 X=02 Y=00 P=30 S=00 

1007 EO 03 

A=02 X=02 Y=00 P=B0 S=00 
1009 DO F9 
A=02 X=02 Y=00 P=B0 S=00 
1004 69 01 

A=03 X=02 Y=00 P=30 S=00 

1006 E8 

A=03 X=03 Y=00 P=30 S=00 

1007 EO 03 

A=03 X=03 Y=00 P=33 S=00 
1009 DO F9 

A=03 X=03 Y=00 P=33 S=00 
100B 00 

A=03 X=03 Y=00 P=33 S=00 
DEBUG 


CPX #$03 
BNE $1004 
ADC #$01 
INX 

CPX #$03 
BNE $1004 
ADC #$01 
INX 

CPX #$03 
BNE $1004 
BRK 


What happened? The first part of the program rolled by so fast that we 
couldn’t read it. The video screen can only hold 24 lines of information atone 
time. Now what? 

Looking in the Atari Assembler Manual, I see a DEBUGGER command: 

SXXXX Single-step operation 

Let’s try that. The instructions in the manual say to type in S followed by 
the address of the first instruction. Then type S and press the RETURN key. Do 
this last operation repeatedly to see each step. Here goes. 


DEBUG 
SI 000 

1000 18 CLC 


A=03 X=03 Y=00 P=32 S=00 

debugN 


The value 3 is left over 
from the last program. NEW 
does not change the ma¬ 
chine language memory or 
registers only the Text Edit 
Buffer. 
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The computer stops here, but it’s only waiting for you to type an S and 
press RETURN. So .. . 
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We have now used the A (accumulator) and the X registers. Since the Y 
register is used in the same way as the X register, we will pass it over for the time 
being. You no doubt noticed that the value in the Y register did not change in 
each of the programs that we used. 

Before we leave this program, let’s go back to the Writer/Editor Program. 
You do this by typing an X and pressing the RETURN key. 



Remember, you can list assembly language programs in the assembler’s 
Writer/Editor Program just like you LIST in BASIC. 
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EDIT 

LIST 

10 *=$1000 
20 CLC 
30 LDA #0 
40 TAX 
50 LOOP ADC #1 
60 I NX 
70 CPX #3 
80 BNE LOOP 
90 END 


This feature of the Writer/Editor Program can be very helpful when editing 
a program to make changes due to programming errors or to make modifications 
for any other reason. 


THE PROCESSOR STATUS REGISTER 

This register holds seven bits of information about the status of the micro¬ 
processor. The eighth bit of the register is not used. The individual information 
bits are called flags. These flags are always in one of two conditions: SET to one 
(1) or RESET to zero (0). The flags are called: Carry, Zero result, Interrupt 
disable, Decimal mode, Break command, Overflow, and Negative result. Here is 
the position that each flag occupies in the register. 

Bit 

number—►-B 7 B g B $ B 4 B 3 B 2 B 1 B Q 

I N I V I I B I D I I I Z I C I 


Figure 5-1. Processor Status Register 

where: N = Negative result 
V = Overflow 
B = Break command 
D = Decimal mode 
I = Interrupt disable 
Z = Zero result 
C = Carry 
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B 0> Carry bit This bit is modified as a result of certain arithmetic and logic 
operations. It can also be SET or RESET by programmed instruction. We 
will be using it later. 

B 1; Zero bit This flag is automatically SET when any data movement or arith¬ 
metic operation has a result equal to zero. It was tested by the BNE 
(Branch on result not equal) in the programs of Chapter 4 and Chapter 5. 
See page 59 for an example. 

B 2 , Interrupt disable bit This flag controls the effect of the interrupt request 
pin of the microprocessor. We will not be concerned with this bit for now. 
B 3 , Decimal mode bit This flag controls whether or not the addition and sub¬ 
traction operations are performed by the computer as binary or decimal. 
More on this later. 

B 4 , Break command bit This bit is SET only by the microprocessor. It is used 
during interrupts. It appeared in our display at the end of the programs 
when we had executed a trace or single-step execution. 

B 5 , Expansion bit This bit is not used at present. It is reserved for future ex¬ 
pansion of the 6502 microprocessor. 

B 6) Overflow bit This bit is used to indicate that an overflow has occurred in a 
signed binary arithmetic operation. More on this later when we get to signed 
number arithmetic operations. 

B 7 , Negative bit This bit tells whether the result of some arithmetic operation 
is negative or not. We’ll discuss this in detail when we get to signed number 
arithmetic operations. 

It may seem like we are putting you off on many of the flags in the Proces¬ 
sor Status Register. We are! We’ll introduce each of the flags as they are used by 
our programs. The first one that you have encountered is the Zero flag. 

If you look back to the trace of the program in Figure 4-5, the first and 
second execution of the CMP #3 instruction at location 1005 shows: 


First 

execution -*■ 1005 C9 03 CMP #$03 

A=01 X=00 Y=00 P=B0 S=00 


Second 

execution 


1005C9 03 CMP #$03 

A=02 X=00 Y=00 P=B0 S=00 


Notice that the Processor Status Register (P) 
holds the value B0. 
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1 0 1 1 0 0 0 0 


X 


Zero flag = 0 (not SET) 


This means that when the value in the 
accumulator was compared to 3, the result 
(1-3 or 2-3) was not equal to zero. 


Therefore, the BNE (Branch on result not equal to zero) was taken. 
However, when this same instruction was executed the third time, the dis¬ 
play showed: 


Third 

execution -> 1005 C9 03 CMP #$03 

A=03 X=00 Y=00 P=33 S=00 

t-P has changed 


The Processor Status Register now holds 33. 


0 0 1 1 0 0 1 1 


X 


Zero flag = 1 (SET) 


The value in the accumulator (03) is equal 
to 3. The result (03-03) does equal zero. 


The branch (BNE) is not taken, and the execution of the program stops. 

You can see that by looking at certain bits in the Processor Status Register, 
the computer can make decisions (such as the order in which instructions are 
executed) depending on certain conditions. This type of decision making adds 
great power to the capability of both the computer and the programmer. 

Some instructions affect the status bits of the Processor Status Register 
and others do not. Here is a table of the instructions we have covered so far and 
the flags that they affect in the Processor Status Register. 
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Instruction Status Bits A ffected 


PLA 

LDA 

ADC 

STA 

RTS 

CLC 

LDX 

TXA 

INX 

CPX 

BNE 

CMP 

SBC 

TAX 

SEC 


Z,C 

N,Z 

N,V,Z,C 

none 

none 

C 

N,Z 

N,Z 

N,Z 

N,Z,C 

none 

N,Z,C 

N,V,Z,C 

N,Z 

C 


Figure 5-2. Effect of Instructions on Flag Bits 


The following table shows the status flags that are affected by each 6502 
instruction. X means that the flag is affected. The result will depend upon the 
condition, or status, resulting from the operation performed by the instruction. 
A one indicates that the flag is set. A zero indicates that a flag is reset. 


Mnemonic 

Code 

Operation Performed 

Status Flags 

N 

* 


B 

D 

/ 

7 1 

c 

ADC 

Add memory to accumulator with carry 

X 

X 





X 

X 

AND 

AND memory with accumulator 

X 






X 


ASL 

Shift left one bit (memory or accum.) 

X 






x 

X 

BCC 

Branch on carry clear (If C=0) 









BCS 

Branch on carry set (If C=1) 









BEQ 

Branch on result zero (If Z=1) 









BIT 

Test bits in accumulator with memory 

X 

X 





X 


BMI 

Branch on result minus (If N=1) 









BNE 

Branch on result not zero (If Z=0) 









BPL 

Branch on result plus (If N=0) 









BRK 

Force Break 






1 



BVC 

Branch on overflow clear (If V=0) 









BVS 

Branch on overflow set (If V=1) 









CLC 

Clear carry flag 








0 

CLD 

Clear decimal mode 





0 _ 







Mnemonic 

Code 

Operation Performed 

Status Flags 

\N_ 

V 


B 

D 

' 

z 

c 

CLI 

Clear interrupt disable flag 






0 



CLV 

Clear overflow flag 


0 







CMP 

Compare memory and accumulator 

X 






X 

X 

CPX 

Compare memory and index X 

X 






X 

X 

CPY 

Compare memory and index Y 

X 






X 

X 

DEC 

Decrement memory by one 







LX 

X 

DEX 

Decrement index X by one 







fx 

X 

DEY 

Decrement index Y by one 







X 

X 

EOR 

Exclusive OR memory with accumulator 







X 

X 

INC 

Increment memory by one 







X 

X 

INX 

Increment index X by one 







X 

X 

INY 

Increment index Y by one 







X 

X 

JMP 

Jump to new location 









JSR 

Jump to new location savejtn. add. 









LDA 

Load accumulator from memory 







X 

X 

LDX 

Load index X from memory 







X 

X 

LDY 

Load index Y from memory 







X 

X 

LSR 

Shift right one bit (memory or accum.) 

0 






X 

X 

NOP 

No operation 









ORA 

OR memory with accumulator 

X 






X 


PHA 

Push accumulator on stack 









PHP 

Push processor status on stack 









PLA 

Pull accumulator from stack 







X 

X 

PLP 

Pull processor status from stack 

X 

XJ 

X 

X 

X 

X 

X 

X 

ROL 

Rotate one bit left (mem. or accum.) 

X 






X 

X 

ROR 

Rotate one bit right (mem. or accum.) 

X 






X 

X 

RTI 

Return from interrupt 

x_ 

x_ 

X 

x_ 

_x 

_x 

21 

x_ 

RTS 

Return from subroutine 









SBC 

Subtract memory and borrow from 










accum. 

x_ 

x_ 





21 

X 

SEC 

Set carry flag 








1 

SED 

Set decimal mode 





1 




SEI 

Set interrupt disable flag 









STA 

Store accumulator in memory 









STX 

Store index X in memory 









STY 

Store index Y in memory 









TAX 

Transfer accumulator to index X 

"x 






Y 


TAY 

Transfer accumulator to index Y 

X 






X 


TSX 

Transfer stack pointer to index X 

X 






X 


TXA 

Transfer index X to accumulator 

X 






X 


TXS 

Transfer index X to stack pointer 









TYA 

Transfer index Y to accumulator 

X 






21 
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Flag abbreviations are: 

N Negative result flag 
V Overflow flag 

Expansion flag (not labeled) 
B Break command flag 


D Decimal mode flag 
I Interrupt disable flag 
Z Zero result flag 
C Carry flag 



The Flags are up! 


THE STACK POINTER REGISTER 

Temporary storage is sometimes required to save current values of a regis¬ 
ter while it is being used for a second task. When that task is finished, the origi¬ 
nal value is replaced in the register. The microprocessor uses an area of RAM 
called a stack for this purpose. Values that are saved in this area are arranged like 
a stack of cards with each card having a value. Each value saved is placed on the 
top of the stack. When the values are retrieved, they are taken from the top of 
the stack also. The last value put on the stack is always the first value taken off. 



The Stack Pointer Register is a 16-bit register that keeps track of the mem¬ 
ory address of the top of the stack. 

Example: 

Suppose the top of the stack is originally at address 01FF. If two 
data values are placed on the stack, the Stack Pointer Register would 
then contain the value 01FD. 

Stack Pointer 
o riginall y 
fOTFFl 

01 FD ? +- Next value here 

01FE 65 2nd value placed on 
01 FF 10 «- 1st value placed on 
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Stack Pointer 
now 

lOlFDb -^ 

v the next location where data is to be placed 

The process is reversed when data is taken off the stack. The stack pointer 
would be automatically incremented to point at 01FE and the value 65 returned. 
When ready to remove the value 03, the stack pointer would again be incremented 
and the 03 returned. The Stack Pointer Register would then contain 01FF again. 

There are four machine language instructions that the programmer may 
use to move data on or off the stack. Data may be saved and retrieved from the 
Accumulator or the Processor Status Register. 

1. PHA (PusH Acummulator on stack) 

Op Code = 48 
Implied mode 

2. PHP (PusH Processor status on stack) 

Op Code = 08 
Implied mode 

3. PLA (PulL Accumulator from stack) 

Op Code = 68 
Implied mode 

4. PLP (PulL Processor status from stack) 

Op Code = 28 
Implied mode 


ADDRESSING MODES 

There are several different addressing modes used by the 6502 micropro¬ 
cessor. Some instructions are only used in one addressing mode. Others may be 
used in more than one mode. So far, we have only used three modes: the Imme¬ 
diate, the Implied, and the Relative. 

The addressing modes may be classified into two types: Indexed and Non- 
Indexed. Let’s first consider the Non-lndexed Addressing modes. They are the 
simplest to use and understand. 

The Implied Addressing Mode 

Instructions using Implied Addressing are one byte long. That byte con¬ 
tains the Op Code, which designates an operation that is internal to the micro¬ 
processor, and no operand is involved. Examples that we have used in this chap¬ 
ter are INX and TAX. 

page 74 INX (Increment X register by one) 

Op Code E8 

Status flags effected: N and Z 
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page 76 TAX (Transfer Accumulator to X register) 

Op Code AA 

Status flags effected: N and Z 

The Op Code totally defines the operation of Implied Addressing Instructions. 
Therefore, only one byte is needed to describe the operation. Instructions used 
in this mode are not used in any other mode. 

The Immediate Addressing Mode 

Instructions using the Immediate Addressing mode employ two bytes to 
describe the operation. The first byte contains the Op Code specifying the opera¬ 
tion and the addressing mode. The second byte contains a constant value known 
at the time a program is being written. Putting these values directly in the pro¬ 
gram saves the programmer from loading them into memory and retrieving them 
when needed. 

You have used the following Immediate Addressing mode instructions in 
Chapters 3, 4, and 5. 

page 42 CPX (Compare to X register) 

Op Code EO (If Immediate Addressing) 

Second byte OA (Value X is compared to) 

Status flags affected: N,Z and C 
page 42 LDX (Load the X register) 

Op Code A2 (If Immediate Addressing) 

Second byte 00 (Value loaded in X) 

Status flags affected: Z and C 
page 57 LDA (Load the Accumulator) 

Op Code A9 (If Immediate Addressing) 

Second byte 00 (Value loaded) 

Status flags affected: N and Z 
page 57 ADC (Add to Accumulator with carry) 

Op Code 69 (If Immediate Addressing) 

Second byte 01 (Value added) 

Status flags affected: N,Z,C and V 
page 57 CMP (Compare to Accumulator) 

Op Code C9 (If Immediate Addressing) 

Second byte 03 (Value accumulator is compared to) 
Status flags affected: N,Z and C 


Immediate addressing is the simplest way to manipulate constants. All of 
the instructions used in this mode may also be used in other modes. The Op 
Code of the instruction will be different for each mode that it is used in so that 
the computer will know which mode is desired. 
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The Relative Addressing Mode 

All of the branch instructions use this, and only this, mode. They are two- 
byte instructions. The Op Code occupies the first byte. The second byte con¬ 
tains a signed number that specifies the length of the branch {if the branch is 
taken). The second byte is ignored if the conditions existing do not require the 
branch to be taken. At the time the decision (to branch or not) is taken, the pro¬ 
gram counter is pointing at the next instruction. You have used one instruction 
in the Relative Addressing Mode, BNE. 

page 60 BNE (Branch on result not equal to zero) 

Op Code DO 

Second byte FA (equivalent to -6: back 6 locations) 
Status flags affected: none 

Branches are made, or not made, depending on the status of certain flags 
of the Processor Status Register (N,V,Z or C). Only branch instructions use this 
mode. 

The Absolute Addressing Mode 

Absolute Addressing Instructions contain three bytes: one for the Op 
Code and two for the address operand. The low-order address byte occupies the 
second byte, and the high-order address byte occupies the third byte. The pro¬ 
grammer can therefore specify a full 16-bit address to access any memory loca¬ 
tion. It is considered to be the normal mode for addressing. You have used this 
mode in Chapter 2 with a STORE instruction (page 21). This mode will be used 
again in the next chapter. 

Example: 

LDA (Load Accumulator) 

Op Code AD (If Absolute Addressing) 

Second byte F3 (low-order address) 

Third byte 10 (high-order address) 

Status flags affected: N and Z 

This example would load the value that is contained in memory location 
10F3 into the accumulator. The value held in 10F3 remains the same. 

0 Memory 10F3 


The Zero Page Addressing Mode 

Zero Page instructions are two bytes long. The first byte contains the Op 
Code, and the second byte contains the low-order byte of the address operand. 
The high-order address byte is assumed by the microprocessor to be zero (there¬ 
fore, its name). The zero page of memory runs from 0000 through 00FF. Each 
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consecutive block of 256 locations is called a page of memory. The advantage of 
zero page instructions is the saving of one byte in the instruction. The time neces¬ 
sary to execute the instruction is therefore shorter than that of Absolute Ad¬ 
dressing. The user should organize his use of memory so that the most frequent¬ 
ly accessed memory is in the zero page. This cannot always be done because 
manufacturers of computers quite often use this memory in their operating 
system. We have not used any instructions in this mode yet. 

Example: 

LDA (Load the Accumulator) 

Op Code A5 (If Zero Page Addressing) 

Second byte 80 (low-order address byte) 

Status flags affected: N and Z 

This example would load the accumulator with the contents of memory 
location 0080. 

We will hold off a discussion of Indexed Addressing modes until Chapter 
8, where they are first used. 


INSTRUCTION SET WITH ADDRESSING MODES 


Mnemonic 

Code 

Op 

Codes 

1 * 

§ I 

Zero Page 

Zero Page, X 

Zero Page, Y 

Absolute 

Absolute, X 

Absolute, Y 

Implied 

Relative 

Indexed Indirect 

Indirect Indexed 

Indirect 

ADC 

_ 

69 

65 

75 

- 

6D 

7D 

79 

~ 

_ 

61 

71 

_ 

AND 

- 

29 

25 

35 

- 

2D 

3D 

39 

~ 

- 

21 

31 

- 

ASL 

0A 

- 

06 

16 

- 

0E 

IE 

- 


- 

— 

- 

— 

BCC 


- 

- 


- 

- 

- 

— 


90 

- 

- 

- 

BCS 


- 

- 


- 


- 


~ 

B0 

- 

- 

- 

BEQ 


- 

- 


- 


- 


~ 

F0 

- 

- 

- 

BIT 

- 

- 

24 

- 

- 

2C 

- 


- 


- 

- 

- 

BMI 

- 

- 

- 

- 

- 

- 

- 

- 

- 

30 

- 

- 

- 

BNE 

- 

- 

- 

- 

- 

- 

- 

- 

- 

DO 

- 

- 

- 

BPL 

- 

- 

- 

- 

- 

- 

- 

— 

- 

10 

- 

- 

- 

BRK 

- 

- 

- 

- 

- 

- 

- 

— 

00 

- 

- 

- 

- 

BVC 

- 

- 

- 

- 

- 

- 

- 

— 

- 

50 

- 

- 

- 

BVS 

- 

- 

- 

- 

- 

- 

- 

- 

- 

70 

- 

- 

- 

CLC 

- 

- 

- 

- 

- 

- 

- 

- 

18 

- 

- 

- 

- 

CLD 

- 

- 

- 

- 

- 

- 

- 

- 

D8 

- 

- 

- 

- 

CLI 

- 

- 

- 

- 

- 

- 

- 

- 

58 

- 

- 

- 

- 

CLV 

- 

- 

- 

- 

- 

- 

- 

- 

B8 

- 

- 

- 

- 











I Mnemonic Op 
Code Codes 
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SUMMARY 

The flexibility of the 6502 microprocessor used in the Atari 400/800 com¬ 
puters is achieved through a variety of addressing modes and special-purpose 
registers. 

The registers discussed in this chapter include: 

• Accumulator (A register)—Most operations performed on data take 
place in this register. 

• X Index Register—Used as a scratch pad or as an index in some address¬ 
ing modes. 

• Y Index Register—same function as X Index Register. 

• Processor Status Register (P register)—Contains the microprocessor’s 
status as each instruction is executed. 

• Stack Pointer Register (S register)-Contains the memory location of 
the top of the stack. 

The addressing modes discussed include: 

• Implied—One-byte instructions that need no operand. 

• Immediate—The first byte specifies the operation; the operand (second 
byte) is a one-byte data item. 

• Relative—Used for branch instructions; first byte specifies the kind of 
branch; the one byte operand tells how far and in what direction to 
branch. 

• Absolute—A three-byte instruction; first byte specifies the operation; 
the other two bytes give the operand that consists of a memory address 
to be used. 

• Zero Page—Similar to Absolute Addressing, but only a single-byte oper¬ 
and is necessary for the memory address to be used. 


EXERCISES 


1. How many bits of information can be contained in the accumulator? _ 

bits 

2. Name the two index registers. 

_ and _ 

3. The status flags are contained in which register? 
_register 

4. The register into which data is loaded, stored from, and in which arithmetic 

operations are performed is called: _ 



94 SPECIAL-PURPOSE REGISTERS AND ADDRESSING MODES 


Question 5 through 8 refer to the following program: 

10 *=$1050 

20 LDX #0 
30 LOOPINX 
40 CPX #2 

50 BNE LOOP 

60 END 

5. Which index register is used in the program? _ 

6. Which status flag is used to determine if a branch is taken? _ 

7. What values will appear in the index register as the program is executed? 

8. What will be the starting address of the machine language program when it is 

assembled? __ 

9. The assembler cartridge’s Writer/Editor command to display the assembly 

language program on the video screen is: _ 

(NEW, LIST, fcUN) 

10. The bits of the Processor Status Register are labeled as shown: 

N| V| | B| D| I | Z| C 

(a) Bit Bj contains the _ flag. 

(b) Bit B 7 contains the_ flag. 

(c) The Carry flag is contained in bit__ 

11. When using the stack, the Stack Pointer Register contains the memory ad¬ 
dress of the top of the stack. The last item placed on the stack will be the 
_item removed from the stack. 

(first, last) 

12. How many bytes are used by an Implied Address instruction?_ 

13. What addressing mode is used by Branch instructions?___ 

14. Which instruction is shorter (fewer bytes): 

Absolute or Zero Page? _ 


ANSWERS 

1. 8 bits 

2. X and Y 

3. Processor Status Register 

4. The accumulator (or A register) 



ANSWERS 95 


6. Zero (or Zero flag) 

7. 0,1,2 (or 00000000,00000001,00000010 binary) 

8. 1050 (hex) 

9. LIST 

10. (a) Z (or Zero flag) 

(b) N (or Negative flag) 

(c) B 0 

11. First 

12. 1 (one) 

13. Relative 

14. Zero Page 



Chapter 6 


Branching Out 


In Chapters 3, 4, and 5 we have used a branch instruction (BNE) to per¬ 
form a program loop. Branch instructions are two-byte instructions which use 
the Relative Addressing mode. That is, the address to which the branch is to be 
taken is calculated relative to the current position of the program counter. The 
program counter (see page 000) is used as a pointer to designate where the micro¬ 
processor will obtain the instruction that is to be executed following the instruc¬ 
tion that is currently being executed. It is always one instruction ahead of the 
computer execution. 


Example: 


As this instruction -► 


is being executed, 

Program 

Counter points 


here 


Memory 

1008 

1009 

100A 


OpCode Instruction 

DO BNE 

F9 

00 BRK 


Therefore, the branch is taken relative to the program counter (or one memory 
location beyond the second byte of the branch instruction). The operand (sec¬ 
ond byte—F9 in this example) used with the branch instruction tells how far and 
in what direction the branch should be taken. 

When used as the operand in a branch instruction such as BNE, all hex 
values from 01 through 7F cause a branch forward from the current position of 
the program counter. The following instruction would cause a branch forward 
from memory location 100A (where the program counter points as the BNE in¬ 
struction is executed) to hexadecimal memory location 1012 (100A+8). 

1008 DO BNE 08 

1009 08 


96 
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An example of the above as used in a section of a program follows: 



1006 

E0 

CPX 03 

Compare the value of the 


1007 

03 


X register with 03 hex. 


1008 

DO 

BNE 08 

Branch, if Y is not equal to 

Program ) 

1009 

08 


03, forward 8 steps. 

starts ( 

100B 




here J 

100C 





100D 





100E 




Branch 

100F 




forward 

1010 




8 steps 

1011 









not=03 

1013 





1014 





All hex values from 80 through FF are used by branch instructions as 
backward (or negative) branches. In the “Program to Count in Accumulator” 
(Chapter 5) the instruction used is: 

1008 DO BNE LOOP The assembler looked for the label LOOP 
and counted back to see where to find it. 


1009 F9 Branch, if X is not equal to 03, backward 

7 steps. 


The branch is made backward (or in the negative direction) since F9 is between 
80 and FF. Counting back 7 steps from location 100A puts the branch destina¬ 
tion at 1003, the start of the loop. 


PROGRAM TO COUNT IN ACCUMULATOR 


1000 

1001 

1002 

Branch f-1003 

back 7 j 1004 

1005 

! 1006 

1007 


1009 

Program *-► 100A 

Counter 


A9 

00 

AA 

69 

01 

E8 

E0 

03 

DO 

F9 

00 


here when BNE is executed 


LDA #0 

TAX 
ADC #1 

INX 
CPX #3 

BNE 

BRK 
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We will not go into the method used by the computer to determine the values of 
negative numbers. Instead, we will provide tables to determine the operand used 
with the branch. The assembler takes care of these details if you provide it with 
appropriate labels. 

Remember that forward branches will use an operand in the range of 1 
through 7F, and backward branches will use an operand in the range of 80 
through FF. 


EXAMPLES USING FORWARD BRANCHES 


1. 100E 

100F 
■-*'1010 


*—1017 


DO 

07 


Program counter starts at 1010 
BNE 07 Branch desired to 1017(7 steps) 

Look up in table: 

Steps Branch 

Forward Operand 

(Decimal) (Hex) 

7 07 *- Operand 


If condition tested is not equal to zero, 
branch forward to 1017 (1010+7 steps). 

2. 1010 DO BNE IF Program counter starts at 1010 

1009 1F Branch desired to 102F (31 decimal steps) 

.— 1010 



Look up in table: 

Steps Branch 

Forward Operand 

(Decimal) (Hex) 

31 IF +- Operand 


If condition tested is not equal to zero, 
branch forward to 102F (1010+1F hex steps). 


3. 100E DO 

100F 77 

r-1010 

i 

i-1087 


BNE 77 Program counter starts at 1010 

Branch desired to 1087 (119 decimal steps) 

Look up in table: 

Steps Branch 

Forward Operand 

(Decimal) (Hex) 

119 77 +-Operand 


If condition tested is not equal to zero, 
branch forward to 1087 (1010+77 hex steps). 





EXAMPLES USING BACKWARD BRANCHES 99 


4. 100E DO 

100F 5B 
plOlO 

^ 106 B 


BN E 5B Program counter starts at 1010 

Branch desired to 106B (91 decimal steps) 

Look up in table: 

Steps Branch 

Forward Operand 

(Decimal) (Hex) 

91 5B <- Operand 


If condition tested is not equal to zero, 
branch forward to 106B (101CH5B hex steps). 


EXAMPLES USING BACKWARD BRANCHES 


1. 


|-*-100B 

! ioio 
! ion 
*-"1012 


DO 

F9 


Program counter starts at 1012 
Branch desired to’lOOB (-7 steps) 


Look up in table: 

BNE F9 Steps Branch 
Backward Operand 
(Decimal) (Hex) 

7 F9 


Operand 


If condition tested is not equal to zero, 
branch backward to 100B (1012-7 steps). 


2 . 

pOFF3 


Program counter starts at 1012 
Branch desired to FF3 (-31 decimal steps) 


| . Look up in table: 

j 1010 DO BNE El Steps Branch 
| 1011 El Backward Operand 

*-►1012 . (Decimal) (Hex) 

31 El 


Operand 


If condition tested is not equal to zero, 
branch backward to FF3 (1012-1F hex steps). 


pOF9B 

j 1010 DO 
J 1011 89 
*-*' 1012 


Program counter starts at 1012 
Branch desired to F9B (-119 decimal steps) 


Look up in table: 

BNE 89 Steps Branch 
Backward Operand 
(Decimal) (Hex) 

119 89 


Operand 


If condition tested is not equal to zero, 
branch backward to F9B (1012-77 hex steps). 








Figure 6-1. Forward Branches 
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Program counter starts at 1012 
Branch desired to FB7 (-91 decimal steps) 

Look up in table: 

DO BNE A5 Steps Branch 
A5 Backward Operand 

(Decimal) (Hex) 

91 AS 

If condition tested is not equal to zero, 
branch backward to FB7 (1012-5B hex steps). 

NOTE—All of the above calculations were performed with hex numbers. Hexa¬ 
decimal subtraction will be discussed in Chapter 9. The table in Figure 
6-2 will give you the necessary operand for backward branches. 

All branch instructions, listed in the following table, use the Relative 
Addressing mode. The status flags that determine the condition on which the 
branch is taken, or not taken, are given in the table. 


1010 

1011 

-1012 


Mnemonic 

Code 

Instruction 

Status 

Flag 

Conditions 
for Branch 

BCC 

Branch on Carry Clear 

c 

0 

BCS 

Branch on Carry Set 

c 

1 

BEQ 

Branch on result zero 

z 

1 

BMI 

Branch on result minus 

N 

1 

BNE 

Branch on result not zero 

z 

0 

BPL 

Branch on result positive 

N 

0 

BVC 

Branch on overflow clear 

V 

0 

BVS 

Branch on overflow set 

V 

1 


Figure 6-3. Status Flags for Branches 

In order to demonstrate some of the branch instructions, we will write 
some short demonstration programs that perform arithmetic operations. 

USING THE CARRY FLAG LL I I I I I |C| Process Status Register 
Vcarry Bit 

Suppose you were using the machine language subroutine on page 39, 
and you input the decimal numbers 123 and 133. The result of their sum would 
be displayed as zero because the result is too large to be contained in one byte. 
An extra bit is needed to express the true result. 





USING THE CARRY FLAG 103 


The sum of that problem: 

Decimal Binary 
123 - 01111011 
133 = 10000101 
Sum = 1 00000000 

extra 8 bits displayed 

When an extra bit (as in this example) occurs from the addition of two 8- 
bit numbers, the computer automatically sets the carry flag (C=1). You can ver¬ 
ify this by using the Atari Assembler Cartridge to enter the following program. 



■*- Clear the carry flag 
*- Load hex 7B (decimal 123) 
<- Add hex 85 (decimal 133) 


Then assemble the program by typing: ASM 



Notice the symbols (#and $) used with the operands in lines 30 and 40 of 
the Source Program (the Assembly Language program). The # symbol tells the 
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computer that the LDA and ADC instructions are to be used in the Immediate 
mode. The $ symbol tells the computer that the numbers in the operand are to 
be treated as hexadecimal values. The symbols are a necessary part of the assem¬ 
bly language instruction. 

Enter the Debugger Program and trace the program. In this way, you can 
watch the changes in the Processor Status Register (P) where the status flags are 
stored. You will want to keep your eye on the Carry bit (flag) in the Processor 
Status Register before and after the add instruction is used. 

r 


EDIT 

BUG 

DEBUG 

T1000* 


*- Type BUG to enter the DEBUGGER 

•*- Type T1000 to trace the program 
beginning at memory location 1000 


1000 18 CLC 

A=00 X=00 Y=00 P=B0 S=00 

1001 A9 7B LDA #$7B 

A=7B X=00 Y=00 P=30 S=00 

1003 69 85 ADC #$85 

A=00 X=00 Y=00 P=33 S=00 
1005 00 BRK 

A=00 X=00 Y=00 P=33 S=00 
DEBUG 


Notice that at step 1003 the accumulator changed to zero, and the Processor 
Status Register changed from 30 to 33. The accumulator tells us that the sum is 
zero, but consider what the P register shows. 


N V B D I Z C 


PROCESSOR 

STATUS 

REGISTER 


| 0 | 0 | 1 |1 I 0 I 0 I 0 I 0~| Before step 1003 



1 0 | 0 11 11 1 0 I 0 I 1 I 1~| <- After step 1003 
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We can consider the result to be a combination of the carry bit and the 
value in the accumulator. 

In Hexadecimal 1+00 = 100 


carry bit 

In decimal this would be 256 + 0 = 256 


By expanding our program, we can store the results in memory by making 
use of the the Branch on Carry Clear (BCC) instruction. Use the NEW command 
to clear the EDIT Buffer. 

Using the Writer/Editor Program of the Assembly Cartridge: 


EDIT 

10 *=$1000 
20 CLC 
30 LDA #$00 
40 STA $1050 
50 LDA #$7D 
60 ADC #$A4 
70 STA $1051 
80 BCC END 
90 INC $1050 
100 END 


Load and store 0 in 1050 

(7x16)+13 = 125 decimal 
(10x16)+4 =164 decimal 
Sum = 289 decimal 

= 256 + 32 + 1 


1 



stored in 1050 


2 1 hex 

stored in 1051 


The program adds two hex numbers and stores the low 8 bits from the 
accumulator into memory location 1051. If there was a carry, memory location 
1050 will be incremented at line 90. If no carry is made, the instruction (BCC) 
at line 80 will cause the computer to skip over the INC instruction at line 90 and 
go to the end of the program. Thus, memory location 1050 will contain the 
extra bit when a carry has been made but will be zero if no carry was made. The 
combination of memory locations 1050 and 1051 will provide the complete re¬ 
sult. Assemble the program and execute it. Then look at the results: 

Assembly 
Type: ASM 


(OOOO 10 *=$1000 


1000 18 20 CLC 


1001 A900 


30 


LDA #$00 
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1003 8D5010 40 

1006 A97D 50 

1008 69A4 60 

100A 8D5110 70 

100D 9003 80 

100F EE5010 90 

0100 END 

EDIT 


STA $1050 
LDA #$7D 
ADC #$A4 
STA $1051 
BCC END 
INC $1050 


Notice that the STA operand and the INC operand take two bytes for the 
address involved. The $ sign once again indicates a hexadecimal value. The 
Branch on Carry Clear operand shows a forward branch of 3 steps from 100F to 
1012 where the program stops. 

This is the first time you have used the INC instruction. It is used to incre¬ 
ment by one the value in the specified memory location. It is similar to the INX 
instruction (increment the X register) that you used earlier. 

Example: 

INC (Increment memory) 

Op code EE (If Absolute mode addressing) 

Second byte 50 (Least significant address byte) 

Third byte 10 (Most significant address byte) 

Status flags affected: Z and C 
DEBUG and Execute 

Type: BUG 


BUG 

DEBUG 


Type: T1000 (to trace the program) 
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'debug 

T1000 

1000 18 CLC 

A=D7 X=00 Y=00 P=B0 S=00 

1001 00 LDA #$00 

A=00 X=00 Y=00 P=32 S=00 

1003 8D5010 STA $1050 

A=00 X=00 Y=00 P=32 S=00 
1006 A9 7D LDA #$7D 

A=7D X=00 Y=00 P=30 S=00 
1008 69 A4 ADC #$A4 

A=21 X=00 Y=00 P=31 S=00 
100A 8D5110 STA $1051 

A=21 X=00 Y=00 P=31 S=00 
100D 90 03 BCC $1012 

A=21 X=00 Y=00 P=31 S=00 
100F EE 5010 INC $1050 

A=21 X=00 Y=00 P=31 S=00 
1012 00 BRK 

A=21 X=00 Y=00 P=31 S=00 
DEBUG 


Carry is set,--. 

-no branch / 

/ C flag 

p fooTioooi| 

3 1 


Notice that a branch was not made at 100D (the Carry flag was not clear, 
it was set). Therefore the memory location 1050 was incremented at line 100F. 


Check Results 


To check the results, you will want to display the memory locations 1050 
and 1051 to verify that the answer is correct. 



DEBUG 

D1050,1051 


D for Display 
(Display memory 
locations 1050 through 
1051) 


1050 

DEBUG 


01 21 


the hex result = (0X16 3 )+(1X16 2 )+(2X16)+1 
= 0 + 256 + 32 +1 

= 289 decimal 
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We could use the Branch on Carry Set (BCS) instruction in the previous 
program instead of the Branch on Carry Clear. 

Using BCC Using BCS 


010 

*=$1000 

010 

*=$1000 

020 

CLC 

020 

CLC 

030 

LDA #$0 

030 

LDA #$0 

040 

STA $1050 

040 

STA $1050 

050 

LDA #$7D 

050 

LDA #$7D 

060 

ADC #$A4 

060 

ADC #$A4 

070 

STA $1051 

070 

STA $1051 

080 

BCC END ) 

( 080 

BCS SET 

090 

INC $1050 > 

change ) 090 

JMP END 

100 

END ) 

) 100 

SET INC $1050 



' 110 

END 


The result of these two programs would be the same. The program using 
BCS would jump to the END at line 90 if the Carry flag had not been set. It 
would branch from line 80 to line 100 if a carry had been set. 

The JMP instruction at line 90 in the second program is similar to a branch 
instruction. However the jump is made regardless of any condition. Therefore it 
is called an unconditional instruction. It is used here in the Absolute Addressing 
mode. 


All BRANCH instructions are dependent on some condition expressed 
by the status flags in the Processor Status Register. 


All JUMP instructions are unconditional. 


USING THE ZERO FLAG I I 1 1 I I lz| 1 Processor Status Register 
Zero bit 


In Chapter 4, you used a program which counted from 1 through FF. The 
counting loop was accomplished by comparing the value in the accumulator with 
FF and using the Branch on result Not Equal zero (BNE). This was the assembler 


10 *=$1000 
20 CLC 

30 LDA #0 

40 LOOP ADC #1 

50 CMP #$FF 

60 BNE LOOP 

70 END 
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The companion instruction to BNE is BEQ (Branch on result EQual to 
zero). The counting program could be written to use the BEQ instruction in the 
following way: 

10 *$1000 
20 CLC 

30 LDA #0 

40 LOOP ADC #1 

50 CMP #$FF 

60 BEQ END 

70 JMP LOOP 

80 END 

Use the assembler to enter and trace each program. You can see from the 
flowcharts that the first program (using BNE) is more straightforward. However, 
you do have the option of using either instruction (BNE or BEQ). In some pro¬ 
grams the BEQ instruction would be the best choice. 

If you time the traces of the two programs you will find that the first pro¬ 
gram is a little faster. You can see by the printout of the traces that one more in¬ 
struction must be executed each time the second program passes through the 
counting loop. 

Trace of BNE program: 

Video Display at the end of the trace: 



instructions< 
in this i 

loop ( 


1007 DO FA 
A=FD X=00 Y= 
1003 69 01 

A=FE X=00 Y= 
1005 C9FF 
A=FE X=00 Y= 
1007 DO FA 
A=FE X=00 Y= 
1003 69 01 

A=FF X=00 Y= 
1005 C9FF 
A=FF X=00 Y= 
1007 DO FA 
A=FF X=00 Y= 
1009 00 

A=FF X=00 Y= 
DEBUG 


BNE $1003 
=00 P=B0 S=00 

ADC #$01 

00P=B0S=00 A=FE P=B0 

CMP #$FF / 

00 P=B0 S=00 "“'Branch is taken 
BNE $1003 back to 1003 
00 P=B0 S=00 

ADC #$01 ^ 

00 P=B0 S=00 

CMP #$FF A=FF P=33 
00 P=33 S=00 

BNE $1003 Branch is not taken 
00 P=33 S=00 /Program ends 

BRK 

=00 P=33 S=00 




110 BRANCHING OUT 


This trace took approximately 2.3 minutes. 

Notice the Processor Status Register after the Compare instruction: 


First, when A = FE [ 1 0 1 1 0 0 0 ~0~| 

L 


Zero Flag = 0 
Result not = 0 
Branch taken 


Second, when A = FF 0 0 1 1 001 1 


L 


Zero Flag = 1 
Result = zero 
Branch not taken 


Trace of BEQ Program: 

Video Display at the end of the trace: 


4 

instructions 
in this 
loop 


1009 4C03 10 

A=FD X=00 Y=00 
1003 69 01 

A=FE X=00 Y=00 
1005 C9FF 
A=FE X=00 Y=00 
1007 F0 05 
A=FE X=00 Y=00 
1009 4C03 10 

A=FE X=00 Y=00 
1003 69 01 

A=FF X=00 Y=00 
1005 C9FF 
A=FF X=00 Y=00 
1007 F0 05 
A=FF X=00 Y=00 
100C 00 

A=FF X=00 Y=00 
DEBUG 


JMP $1003 
P=B0 S=00 
ADC #$01 
P=B0 S=00 
CMP #$FF 
P=B0 S=00 

BEQ END—s 
P=B0 S=00 

JMP $1003 ; 
P=B0 S=00 
ADC #$01 
P=B0 S=00 
CMP #$FF 
P=33 S=00 
BEQ END 
P=33 S=00 
BRK 

P=33 S=00 




-First A=FE 
' Branch not taken 


Second A=FF 

Branch is taken 
to the end 
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This trace took approximately 3.1 minutes. 


Once again, notice the Processor Status Register after the Compare in¬ 
struction: 


First, when A = FE 1 1 0 1 

1 0 0 0 0 


^—Zero Flag = 0 


Branch is taken 

Second, when A = FF |o 0 1 

1 0 0 1 1 | 


^— Zero Flag = 1 


Branch is not taken 

The BEQ program took a longer time to trace than the BNE program. This differ¬ 
ence in timing would not be noticed if the program is run in the normal manner. 
However, in the trace mode, the time for printing the extra step is noticeable. 


USING THE NEGATIVE FLAG INI I I I I fTl Processor Status 
| Register 

Negative bit 

Once again, let’s use a variation of the counting program to see how some 
branch instructions decide whether a number is positive or negative. We’ll first 
use the Branch on result Plus (BPL) instruction. The N (negative) flag is reset to 
zero for positive numbers and is set to 1 for negative numbers when certain in¬ 
structions are executed. If the Negative flag has been reset to zero, the BPL in¬ 
struction will cause a branch to be taken (because the result is positive). If the 
Negative flag has been set to 1 (result negative), the branch will not be taken. 

BRANCH ON RESULT PLUS DEMONSTRATION 

Using the assembler cartridge, enter the following program in the 
Writer/Editor mode. Type NEW to clear the last program: 

10 *=$1000 

20 CLC 

30 LDA #0 

40 LOOP ADC #1 

50 BPL LOOP 

60 END 

Assemble the demonstration program. Then enter the Debugger Mode and 
trace the program. 
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Process Status Register 
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Negative values can be more dramatically seen by starting with zero in the 
accumulator and subtracting one each time through a loop. 


Operation 

Result 

Signed Decimal 
Equivalent 

0-1 

FF 

-1 

FF-1 

FE 

-2 

FE-1 

FD 

-3 

FD-1 

FC 

-4 

etc 



83-1 

82 

-126 

82-1 

81 

-127 

81 -1 

80 

-128 


You might think of 8-bit signed numbers as locations on a large number 
wheel rather than the usual number line. Then they would look like this. 



Figure 6-4. Signed Number Wheel. Hex Values inside; 
Decimal Equivalents Outside 
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To demonstrate the subtraction of one from the accumulator, we’ll use the 
Branch on result Minus (BMI) to create a loop. The carry bit is used in subtrac¬ 
tion in the borrowing process. When using addition, we cleared the Carry bit be¬ 
fore performing the operation. In subtraction, we must set the carry bit before 
performing the operation. Here is the program as entered during the assembler’s 
Writer/Editor mode. 



while minus 


10 

20 

30 

40 

50 

60 


*=$1000 

LDA #0 Set the carry bit 

LOOP SEC for subtraction 

SBC #1 
BMILOOP 
END 


Assemble the program. Then enter the Debug mode and single step through 
the first part of the program. 


'asm 

0000 10 
1000 A900 20 

1002 38 30 LOOP 

1003 E901 40 

1005 30FB 50 

60 END 

EDIT 

BUG «- 

DEBUG 

SI 000 ♦- 


*= $1000 
LDA #$00 
SEC 

SBC #$01 
BMILOOP 

Enter Debugger 

Single step starting at 1000 


"DEBUG 

SI 000 4- First step 

1000 A9 00 LDA #$00 Load 0 in accumulator 

A=00 X=00 Y=00 P=33 S=00 
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You can see that this will go on for some time before we finally reach a 
non-negative number. You can also see that the computer considers FF and FE 
as negative values and therefore branches back to subtract again. It will branch 
back until the accumulator reaches 7F. By looking at the Signed Number Wheel 
in Figure 6-4, you will find that 80 is interpreted as a negative value (-128 deci¬ 
mal). However, 7F is interpreted as positive (+127 decimal). Therefore, the 
branch will not be taken at that point. 

Instead of plodding on through all the negative integers up to and includ¬ 
ing -128, change to the Trace mode to finish up the program. After the last DE- 
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BUG prompt, type T1000 and press RETURN. Now the computer will trace 
through the program, and you can see the END result. 

As seen on the display: 


1005 30 FB BMI $1002 

A=80 X=00 Y=00 P=B1 S=00 

1002 38 SEC 

A=80 X=00 Y=00 P=B1 S=00 

1003 E9 01 SBC #$01 

A=7F X=00 Y=00 P=71 S=00 

1005 30 FB BMI $1002 

A=7F X=00 Y=00 P=71 S=00 
1007 00 BRK 

A=7F X=00 Y=00 P=71 S=00 
DEBUG 


THE OVERFLOW FLAG 

Two branch instructions BVC (Branch on oVerflow Clear) and BVS 
(Branch on oVerflow Set) can also change the normal sequential operation of a 
machine language program. If you are not performing arithmetic with signed 
numbers, the Overflow flag may be completely ignored. We will discuss arith¬ 
metic with signed numbers in Chapter 9. 

| | y| | | | | | | Processor Status Register, 

overflow flag 


•*- 80 still considered 
negative—branch 

■*- Negative flag off (P = 71) 

7F considered positive- 
no branch taken 


SUMMARY 

This chapter discussed branch instructions—what they are and how they 
are used. You learned that: 

• All branch instructions are made in the Relative Addressing mode; 

• Branch instructions cause a branch when a specified condition is true; 

• The Program Counter is moved relative to its current position when a 
branch is taken; 

• The second byte of a branch instruction tells how far and in what direc¬ 
tion (forward or backward) the Program Counter is moved; 
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• Forward branches are taken when the second byte of the branch in¬ 
struction is in the range of 1 through 7F; 

• Backward branches are taken when the second byte of the branch in¬ 
struction is in the range of 80 through FF; 

• The following status flags are used to determine the condition for 
branches: 

Negative 

Overflow 

Zero 

Carry 

• The condition is true when the specified flag is set to one; 

• The condition is false when the specified flat is reset to zero; 

• Hexadecimal numbers can be interpreted as negative values if they are 
in the range of 80 through FF and as positive values when they are in 
the range of 1 through 7F; 

• All branch instructions consider zero a positive value. 


EXERCISES 

1. When the following instruction is being executed, at what memory location 
is the Program Counter pointing? 


(1010, 1011, or 1012) 

Memory Op Code Instruction 

1010 DO BNE 

1011 F9 

2. What status flag will determine whether the branch in Exercise 1 is taken or 

not? _flag 

3. Which direction (forward or backward) will the branch in Exercise 1 be 

taken? _ 

4. Using the tables in Figures 6-1 and 6-2, give the hex operand that should be 
used to make the following branches: 

(a) forward 38 decimal steps_ 

(b) backward 100 decimal steps __ 

(c) forward 93 decimal steps _ 

(d) backward 42 decimal steps_ 

5. Give the two-byte branch instruction which would branch backward 11 
decimal steps if the result of an operation were positive. 
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OpCode Mnemonic 


6. If two hex values are added and the result is greater than FF, what flag will 
be set? 

(Negative, Zero, or Carry) 

7. What hex value would be in the accumulator following the execution of 

these two instructions?__ 

LDA #$7A 
ADC #$87 

8. Tell the contents (0 or 1) of the following flags after the two instructions in 
Exercise 7 have been executed. 

Zero flag _ 

Negative flag_ 

Carry flag_ 

9. Tell which mode of the assembler is used for the following: (Modes are: 
EDIT, ASM, OR DEBUG) 

(a) to LIST a source program_ 

(b) to run an object program_ 

(c) to display a memory location used to store a result in a machine lan¬ 
guage program _ 

(d) to trace an object program_ 

10. Tell what the following mnemonic codes represent: 

(a) BCC_ 

(b) BEQ- 

(c) BPL_ 

(d) BCS _ 

(e) BNE_ 

(f) BMI _ 


ANSWERS 

1. 1012 (always one instruction ahead) 

2. Zero flag 

3. Backward 

4. (a) 26 

(b) 9C 

(c) 5D 

(d) D6 



Op Code 
10 
F5 


Mnemonic 

BPL 
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6. Carry flag for sure (Possibly N,Z) 

7. 01 

8. Zero flag 0 
Negative flag 0 
Carry flag 1 

9. (a) EDIT 

(b) DEBUG 

(c) DEBUG 

(d) DEBUG 

10. (a) Branch on Carry Clear 

(b) Branch on result EQual zero 

(c) Branch on result PLus 

(d) Branch on Carry Set 

(e) Branch on result Not Equal zero 

(f) Branch on result Minus 
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Assembler Review 


This chapter summarizes what you have learned about the Atari Assembler 
and adds some new features that have not been discussed so far. 

An assembly language program is made up of statements containing state¬ 
ment numbers, labels, Op code mnemonics, operands, and comments. The pro¬ 
gram, which is written in the Writer/Editor mode of the Assembler Cartridge, is 
called the source program. You assemble the source program in the Assemble 
mode. This produces a machine language program, called the object program. 
The assembler places this program in memory. The object program is then exe¬ 
cuted in the Debug mode to produce the desired result. 

SOURCE PROGRAM FORMAT 

The source program is made up of statements that begin with a line num¬ 
ber and is terminated by pressing the RETURN key. Statements are broken up 
into the following fields, some of which are optional. 


| Statement number | Label | Op code mnemonic | Operand | Comment | 

' T~// 


Figure 7-1. Statement Fields 

Every statement must start with a statement number that is in the range of 
0 through 65,535. You should number your statements in such a way that new 
ones may be inserted at a later time in case you want to alter your original pro¬ 
gram. Multiples of 10 work well for this purpose (i.e., 10,20,30,etc.). The Writer/ 
Editor has convenient commands for automatically numbering or renumbering 
programs (see page 129). A statement may be up to 107 characters in length. 


720 
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The label field is optional. If it is used, it follows the line number with 
exactly one space between the last digit of the line number and the first letter 
of the label. A label must start with a letter and contain only letters and num¬ 
bers. It can be as short as two characters or as long as the limitation of the state¬ 
ment length. If a label is not used, two spaces or a tab is used between the state¬ 
ment number and the Op Code Mnemonic field (which follows the label field). 


Examples: 

With label 20 LOOP 



number space 

With no label 20 Op Code 

two spaces, or 


20—.—Op Code 
a tab ^vesVspaces 7 


The Op Code Mnemonic must be one of those given in Appendix A or B. 
This field starts at least two spaces beyond the statement number (if no label is 
used) or one space after the label. A mnemonic placed in the wrong field will not 
be identified as an error in the Writer/Editor mode, but will be identified as 
Error -6 when you assemble the program (See Appendix D for Error codes.) 


Examples: 
With label 


With no label 


20 LOOP CLC 


onespace^"”"^ Op Code for Clear Carry 


50 INY or 


t \ 

paces j 


o spaces 
Op Code 
INcrement Y Register 


^8 spaces from 
a tab 


The field of the operand starts at least one space, or a tab, after the 
mnemonic field. Some Op Code mnemonics require an operand, while others 
do not. The form of the operand that is appropriate for each mnemonic code 
that uses one is given in Appendix A. 
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Examples: 

For hex operand 


30, LDA #20 

_ J \ \\ 

two spaces Op Code\ Operand hex 

Immediate Addressing mode 
30 LDA $1100 

Load accumulator-from memory 
location 1100 


For decimal operand 30 LDA #32 


\ 


Immediate Addressing 

10 LDA, 4352^ 


Operand (decimal 32) 


Absolute Addressing 
(no# sign) 


Operand (decimal 4352) 


The last field, comment, appears on the listing of a source program but is 
not assembled. Therefore, it does not appear in the object program. There are 
two ways to enter comments. 

• One way is to enter it in the comment field which occupies the remain¬ 
der of the statement following the operand (if there is one) or the 
mnemonic code (if there is no operand). At least one space separates it 
from the last field used. There may not be enough room to put the en¬ 
tire comment in its field. In that case, you can extend your comment 
into the next line. 


Examples: 

20 CLC GET READY FOR ADDITION 
comment 

30 BNE LOOP IF THE COUNT HAS NOT 
REACHED ZERO GO BACK TO LOOP" 


.Extend comment 
to new line 
(no line number) 


• A second way is to put the comment on its own line. In that case, one 
space follows the statement number, and a semicolon is used before the 
comment. 
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Examples: 

30 CLC 

40 ;GET READY FOR ADDITION 
and 

30 BNE LOOP IF THE COUNT HAS NOT 

40 jREACHED ZERO GO BACK TO LOOP 

METHODS TO USE OPERANDS 

Line numbers, Op Code Mnemonics, and comments are straightforward 
and easy to use. The operands are sometimes tricky and deserve some more ex¬ 
planation. 

Operands may be in the form of hexadecimal numbers, decimal numbers, 
or letters. The programmer has the option to use whichever form is desired. 

A number used as an operand is interpreted as a decimal number by the 
assembler unless it is preceded by a $ sign. If a $ precedes the number, it is inter¬ 
preted as a hexadecimal number. 

Examples: 

40 LDA 4500 -<-4500 is interpreted as a decimal number 

50 STA $1100 -<-$1100 is interpreted as a hexadecimal number 

If a group of letters has been used as a label or have been assigned a nu¬ 
meric value, the letters may be used as an operand. 

Examples: 

20 

30 

40 


80 

90 


90 

In addition to providing data, the operand also tells the computer what 
addressing mode to use for the operation specified by the Op Code Mnemonic. 


ABC=$33 
DEF=51 
LOOP CLC 


BNE LOOP 
CMP DEF 


^LOOP was used as a label previously 


" Decimal value 51 


-Hexadecimal value 33 
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Examples: 


20 

LDA #12 

The # sign indicates the Immediate 
Addressing mode 

30 

CPY $1212 

Absolute Addressing mode (no # sign) 

40 

STA $1250, Y 

Absolute Indexed mode (note: ,Y added) 

50 

ADC ($2B,X) 

Indexed Indirect mode (note: parentheses) 

60 

CMP ($3C),Y 

Indirect Indexed mode (note: placement 
of parentheses) 

70 

INC $3C 

Zero Page mode 

80 

INC $20,X 

Indexed Zero Page mode 


THE ASSEMBLER WRITER/EDITOR MODE 

The Writer/Editor mode (referred to as the Edit mode for convenience) 
controls the communication between you, through the keyboard, and the video 
screen. When you power up your Atari with the Assembler Cartridge installed, 
you should see the Edit mode prompt on the screen. If you do not see the Edit 
prompt at this time, some error or malfunction has occurred. Check your Oper¬ 
ator’s Manual to make sure you have followed all procedures correctly. 



Any entries from the keyboard will now appear in successive locations 
across the screen starting at the cursor ( ) position. The screen is 38 locations 
wide. If the end of a line is reached, there is an automatic "wrap around” so that 
your entries continue on the next line. 


EDIT / 

10 ;THIS PROGRAM WILL DEMONSTRATE ADDI 
TION*^ 

^cursor 


38 locations, 
then wrap 
around 


We have discussed some of the following commands used in the Edit 
mode. Others are new to you. 
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1. SIZE is used to find the location of the Current Line Buffer and Edit 
Text Buffer. Three numbers are displayed when the SIZE command is executed. 



( 


Memory location of 
Current Line 
Buffer 


Memory location where 
next character typed 
will be placed 


‘Highest RAM 
location available 
in your computer 


End of 
8K memory 


3C1 F for 16K 
5C1 F for 24 K 
7C1 F for 32K 
90 F for 48 K 


•*— Your Source Program 
goes here 

I Assembler cartridge and 
I current line buffer 

Current line being 
typed is temporarily 
stored here 



Figure 7-2. Buffer Memory 


The middle number in the example (0880) increases as the Edit Text 
Buffer is filled by your program. Therefore, the SIZE command can be used to 
find out how much memory is being used as you enter the Source Program. The 
machine language Object Program should be placed at memory locations higher 
than that occupied by your Source Program. 

2. LOMEM is used to change the location of the Buffer Memory area. You 
have not used this command yet and may never use it. If you wanted to use 256 
memory locations between 0700 and 0800 in your assembled program, you 
would use the LOMEM command like this: 

'edit 

LOMEM 800 

EDIT 

■ 

Your memory would now be organized for use as shown in Figure 7-3. 
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Edit text buffer 


0800 

0700 


Could be used in 
assembled program 


Figure 7-3. Altered Buffer Memory 

Now give the SIZE command again. 

'edit 

LOMEM 800 

EDIT 

SIZE 

0800 0980 1C1F 

EDIT 

■ 

The location of the buffer areas cannot be changed after you have started 
writing a program. If you use the LOMEM command, it must be the first com¬ 
mand after you power up. 

3. LIST is used to display, on the video screen, the program that is cur¬ 
rently in the Edit Text Buffer. It can be used in several forms. 

(a) LIST to display the whole program 


'edit 

LIST 

10 *=$1000 
20 CLC 
30 LDA #0 
40 LOOP ADC #1 
50 CMP #$FF 
60 BNE LOOP 
70 END 


EDIT 
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(b) LIST 40 to display only line 40 



(c) LIST 50,70 to display all lines 50 through 70 



4. NEW is used to clear the Edit Text Buffer. It does not clear the memory 
occupied by a previously assembled machine language program—only the Edit 
Text Buffer. After this command has been executed, you cannot restore any 
Source Program that existed previously in the Edit Text Buffer. 

If the program in 3a under LIST is in the Edit Text Buffer, and you type 
NEW, the Edit Text Buffer will be cleared. 



5. DEL is used to delete statements from the Edit Text Buffer. You have 
not used this command. It allows you to delete one line or several successive 
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Suppose the program of 3a is still in the Edit Text Buffer, and you want to 
delete line 20. 



Now, take out lines 40, 50, and 60. 



6. REP is used to replace a specified string in the Edit Text Buffer with a 
different specified string. Thus, a program change can be quickly made by one of 
the several forms of this command. Suppose you once again have the program of 
3a in the Edit Text Buffer. 

(a) To replace the first occurrence of the string “LDA #0” with “LDA 
#5”: 
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Old string 
New string 


(b) To replace all occurrences of the string “LOOP” with the string 
“CIRCLE”: 


'EDIT 

REP/LOOP/CIRCLE/,A ^_,A added after 

last backslash 


Lines 40 and 60 would be changed to: 

40 CIRCLE ADC #1 
50 BNE CIRCLE 

Other forms of this command are explained in the Atari Assembler Manual. 


7. NUM is used to number the statements automatically in an assembly 
language program. It can be used in several forms. 

(a) To increment the statement numbers by 10: 

'edit 

NUM 

10" Prints a 10 and skips one space 


Type in the first line and press RETURN 


( EDIT 
NUM 


10 * 
20 ■ 


Type another space, *=$1000 and 
press RETURN 


Prints 20 and skips one space 
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(b) To increment by a value different than 10: 


EDIT 
NUM 3 

3 -«— Now starts at 3 

Type in first line and press RETURN 


f EDIT 
NUM 3 


3 

6 


*=$ 1000 -«— Type space then *=$ 1000 and 
press RETURN 

Prints 6 and skips one space 



(c) To force a new line and change the increment (or the starting line): 


'"edit 

NUM — Regular NUM 

10 *=$1000 
20 CLC 

NUM 50,3 --New NUM form 

50 LDA #0 -*— New line number, 50 

53 LOOP ADC #1 -+— New increment, 3 

56 ■ 


Press RETURN to cancel the NUM command. 


50 LDA #0 
53 LOOP ADC #1 

56 Press RETURN here 

■ NUM is no longer active 

8. REN is used to renumber statements in the Edit Text Buffer. 

(a) To renumber statements in increments of 10 starting with 10, type: 

REN then press RETURN 

(b) To renumber statements in increments of 5 starting with line number 
10, type: 

REN 5 and press RETURN 
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(c) To renumber all statements in increments of 2 starting with line num¬ 
ber 20, type: 

REN 20,2 and press RETURN 

9. ASM is used to transfer from the Writer/Editor Program to the Assem¬ 
bler Program. 

10. BUG is used to transfer from the Writer/Editor Program to the Debug 
Program. 

There are also commands to save and retrieve programs or specific blocks 
of memory. Their use is described in the Atari Assembler Manual and will not be 
repeated here. Each of these commands 

LIST, ENTER, ASM, SAVE, and LOAD 

are used in several forms depending on whether you wish to use the video screen, 
printer, cassette recorder, or disk drive. 


THE DEBUG MODE 

The Debug mode, which is entered from the Writer/Editor mode by typing 
"BUG”, allows you to alter or execute the Object Program that has been assem¬ 
bled. It also allows you to enter and change data tables that the Object Program 
uses. The prompt shown on the video display when you are in this mode is the 
word, DEBUG. 

'EDIT___You type BUG to enter DEBUG 

BUG --' 

DEBUG 

■ 

The command to return to the Writer/Editor mode from the Debug mode 
is the letter, X. 

'edit 

BUG ■«- Type BUG to enter Debug mode 

DEBUG 

X «-Type X to leave Debug 

EDIT *- Now you’re back in the 

■ Writer/Editor mode 

To demonstrate the commands used in the Debug mode, enter the follow¬ 
ing program. 
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'edit 

NUM For automatic numbering by 10 

10 *=$1000 
20 LDY #0 
30 LDA #0 
40 LOOP CLC 
50 INY 
60 ADC #1 
70 CPY #3 
80 BNE LOOP 
90 END 
100 ■ 

Now assemble the program. 


80 BNE LOOP 
90 END 

ASM" Type: ASM and press RETURN 


'oooo 

1000 A000 
1002 A900 

1004 18 

1005 C8 

1006 6901 
1008 C003 
100A D0F8 


10 *= $1000 

20 LDY #0 

30 LDA #0 

40 LOOP CLC 
50 INY 

60 ADC #1 

70 CPY #3 

80 BNE LOOP 


90 END 
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Now, go to the Debug mode. 



There are three ways to execute a program. The method that you choose 
will depend on whether you want to display the steps as they are executed or 
not. 

1. To execute the program without a display, type: G1000 and press the 
RETURN key. 



where your program ended is displayed along 

with the contents of the registers as the- 

program ended. 


Register A (the accumulator) contains a 3. The Y register also contains a 3. 
This is as you would expect. 

2. To TRACE a program, type T1000 and press RETURN. The display 
will show each instruction as it is executed along with the contents of the regis¬ 
ters after the instruction has been executed. 
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3. To SINGLE STEP through a program, type SI000 and press RETURN. 
The display will show the results of the first instruction. To continue the single 
step procedure, type the letter S and press the RETURN key for each successive 
instruction that you want executed. 



4. To DISPLAY the contents of memory, type the letter D followed by 
the address of the memory location that you want to examine. 

(a) To display a single memory location. 



(c) To display more than 8 consecutive locations, type D, the starting 
address, a comma, and the ending address. 
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DEBUG ,-End 

D1000.100B ___Start 

--- 

1000 AO 00 A9 00 18 C8 69 01 

1008 CO 03 DO F8 

DEBUG 


(d) Notice that in b and c above, memory was displayed with a block 
of 8 locations per full line. This will result when the requested start¬ 
ing location ends in 0 or 8 (i.e., 1000, 1008, 1010, 1018, etc.) 
However, if the starting address does not end in 0 or 8, a block 
containing fewer than 8 values will be displayed on the first line. 

Examples: 


'debug 

D1002.100B 

1002 A9 02 18 C8 69 01 -only 6 locations 

1008 CO 03 DO FB displayed 

DEBUG 

D1005,100B 

1005 C8 69 01 --only 3 locations 

1008 CO 03 DO FB displayed 

DEBUG 


5. You can LIST a block of memory with the contents DISASSEMBLED 
into assembly language mnemonics. Type L followed by the starting address or 
the starting and ending address, just as you do for the display command. 

(a) For only one instruction: 


DEBUG 
LI 000,0 
1000 


#$00 


Complete instruction 
starting at 1000 
(two bytes) 


Assembly 
mnemonic 
equivalent to 
memory 
contents 
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(b) For several instructions: 



(c) Since the DEBUGGER starts disassembling from the specified start¬ 
ing location, you must be sure that the specified starting location 
corresponds to the first byte of some instruction in your program. 
Otherwise the DEBUGGER is confused, or interprets the code as 
something different than intended. 

(1) Confusion: 



(2) Misleading address: 




THE DEBUG MODE 137 


6. As shown in earlier programs, the contents of memory can be changed, 
(a) Changing one address: 

Changes contents 
of 1003 to 5 


(b) Changing successive locations. The comma increments the location 
to be changed. 

Puts A9 in 1000 
00 in 1001 
A0 in 1002 

Puts 02 in 1007 
06 in 1009 

but does not change 1008 

7. The contents of a block of memory can be MOVED to a different mem¬ 
ory area. 

Example: 





The move command is then given. 



Block to be moved 

Beginning address to 
which data is to be 
moved 
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8. To VERIFY that data has been moved as desired or that two blocks of 
memory contain the same data, you can compare two blocks of memory. 


Example: 

Using the results of item 7. 

|DEBUG - Block to be compared 

| VII0CK1150,1153 to 1100-1103 

DEBUG -*- If the two blocks 

■ match, nothing is 

displayed 

If 1151 contains 31, not 41: 


Mismatch is displayed 


Other commands and variations of the ones shown in this chapter are given 
in the Atari Assembler Manual. You should explore the manual thoroughly and 
experiment with all commands so that you can use all the facilities of the Assem¬ 
bler Cartridge. 
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Since this entire chapter is a summary of the Assembler commands, no 
chapter summary is given. Go right on to the chapter exercises. 


EXERCISES 

1. The five statement fields of a Source Program are given below. Tell which 
are always used and which are somtimes used in a Source Program statement. 

(a) Statement number_ 

(b) Label _ 

(c) Op Code Mnemonic_ 

(d) Operand_ 

(e) Comment_ 

2. The assembler will interpret some numbers as decimal and others as hexa¬ 
decimal depending on the specified operand. Give the interpretation of the 
following: 

(a) LDA #$13_ 

(b) LDY #14 _ 

3. The SIZE command is given, and the computer displays: 

'"edit 

SIZE 

0700 0880 3C1F 

EDIT 


The computer is then turned off. It is then turned on and the following com¬ 
mands are given. Fill in the display as shown after the final SIZE command. 

'edit 

LOMEM 900 

EDIT 

SIZE 


EDIT 
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Exercises 4 through 10 refer to the following program: 


"edit 

LIST 

10 *=$1000 
20 CLC 
30 LDA #0 
40 LOOP ADC #5 
50 CMP #$50 
60 BNE LOOP 
70 END 


4. Give the value in the accumulator at the end of each of the first five passes 
through the loop. 

1st _ 4th _ 

2nd_ 5th _ 

3rd _ 

5. (a) Will the accumulator ever contain the hexadecimal value 50?_ 

(b) If so, how many times will the loop be executed?_ 

6. What would be the command used to list all lines from 30 through 60, 

inclusive?_ 

7. Give the command that would delete line 20. _ 

8. Give one command that will change the word LOOP in lines 40 and 60 to 

the word ROUND_ 

9. Give a command that would renumber the program starting with statement 
number 100 and numbering each successive statement in increments of 5. 


10. Give the command to enter the Debugger mode and show the prompt that 
results. 

( EDIT 


The following exercises assume that the program preceding Exercise 4 has 
been assembled, and that you are now in the Debugger mode. The assembled 
Object Program is now stored in the following memory locations. 
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Memory 

Contents 

1000 

18 

1001 

A9 

1002 

00 

1003 

69 

1004 

05 

1005 

C9 

1006 

50 

1007 

DO 

1008 

FA 

1009 

00 


11. What is the command to: 

(a) execute the program - 

(b) trace the program _ 

(c) single step the first instruction 


12. If the command: D1000 is executed, show the displayed result. 


f DEBUG 
D1000 


13. Show the display resulting from the command: LI000,0 

f DEBUG 
LI 000,0 


14. If you wanted to change the program so that it would add ten (hex 0A) 
each time through the loop instead of 5, show how to change one memory 
location to accomplish the change. 
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(DEBUG 


15. Show a command to move the program so that the first instruction will be 
in memory location 1120. 

(DEBUG 


ANSWERS 


1. (a) Always 

(b) Sometimes 

(c) Always 

(d) Sometimes (Some Op Codes require operands) 

(e) Sometimes 

2. (a) Hexadecimal 
(b) Decimal 

3 - r. - 

SIZE 

0900 0A80 3C1F 

4. 1st 05 4th 14 

2nd 0A 5th 19 

3rd OF 

5. (a) Yes 

(b) Sixteen times 

6. LIST 30,50 

7. DEL 20 

8. REP/LOOP/ROUND/,A 

9. REN 100,5 
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Chapter 8 


Designing a Program 


A program is usually written to solve a specific problem. The method of 
solving the problem should be determined before any attempt is made to write 
the program to solve it. Since assembly language programming is not interactive 
like BASIC, a detailed plan is needed for each assembler program. 


Sample Problem: Add five pairs of two-digit 
numbers and store the results. 


1. In analyzing the stated problem, you can see that some area of memory 
is needed to hold the five pairs of numbers that are to be added. These will be re¬ 
ferred to as data tables. 

2. You must also provide for five results. Since you will be adding two- 
digit numbers, the sum may be greater than two digits. Therefore, it will be ne¬ 
cessary to provide for two memory locations for each sum. This group of mem¬ 
ory locations will be called the result table. 

3. The addition will be performed on two pairs of numbers at a time with 
the data being accessed from the data tables and the results stored in a different 
table. 

4. You must allocate the necessary memory locations for the program as 
well as the data and result tables. 


NOTICE that you do not know at this time how long the assembled 
assembled program will be. Therefore, you must estimate where the starting 
location of the data will be. We allowed lots of room for the program. 


Now that you have stated the problem in realistic terms, you should think 
through the program in functional blocks. 
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Block of 10 memory 
locations for results 


Block of 5 memory 
locations for 2nd numbers 


Block of 5 memory 
locations for 1st numbers 


Block of ? memory 
locations for 
the assembled 
program 


Figure 8-1. Memory Blocks Used 


Figure 8-2. Functional Blocks 


A. I LOAD the data 
I into memory 


B. ADD the data and 
STORE the results 
in memory 


Think about Block A. You could load the data into the correct memory 
locations using the Assembler Cartridge in the Debug mode. You could also load 
the data tables from the program itself. The latter method consumes time and 
memory space, so we will use the first method. It is more direct, is easily changed 
(if needed), keeps the program simple, and will enable you to use another Assem¬ 
bler Cartridge capability. Therefore, your program will be reduced to Block B. 

Let’s now expand Block B into functional parts. 


Block B 


1. Load one 2-digit number 
into the accumulator. 

2. Add the second 2-digit 
number. 

3. Store the result. 

4. Go back and repeat until 
all 5 sums are performed. 


Figure 8-3. Block B Parts 
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The Absolute Indexed Addressing mode will be the most efficient way to 
load, add and store the numbers. You can use both X and Y registers to index 
the instructions. The program might consist of the following. 


ADD FIVE PAIRS OF NUMBERS 


LDY 

#0 

Load the Y register with an initial value of 
zero. This will index the load and add in¬ 
structions as well as serving as a loop 
counter. 

LDX 

#0 

Load the X register with a value of zero. X 
will serve to index the pair of stored 
results. 

LOOP CLC 


Start of loop. Clear Carry bit in preparation 
for adding a pair of numbers. 

LDA 

$1100,Y 

Load the accumulator from memory loca¬ 
tion 1100+Y. 

ADC 

$1105,Y 

Add with carry the number in memory loca¬ 
tion 1105+Y. 

STA 

$110B,X 

Store the least significant byte of sum in 
memory location 110B+X. 

BCC 

SKIP 

If there was no carry, branch to the instruc¬ 
tion labeled SKIP. 

INC 

$110A,X 

If there was a carry, increment memory lo¬ 
cation 110A+X. 

SKIP INX 


Increase X by two for 

INX 


two-byte result 

INY 


Increase Y by one for next load and sum. 

CPY 

#5 

See if Y = 5 

BNE 

LOOP 

If Y f 5, branch back to instruction labeled 


LOOP for next pair of numbers. 

END End of the program 

ABSOLUTE INDEXED ADDRESSING 

The load, add, increment, and store instructions are all used in the Abso¬ 
lute Indexed Addressing mode. In this mode, a base address is specified. The 
value contained in either the X or Y register is added to the base address to ob¬ 
tain the memory address actually used. 

Examples: 

Suppose the Y register holds the value 3, the X register holds 6, and 
the following values are in memory. 
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Memory 

Value 

1100 

12 

1101 

34 

1102 

56 

1103 

78 

1104 

9A 

1105 

BC 

1106 

DE 

1107 

F0 

1108 

01 

1109 

23 


Here is what happens when you execute the following instructions. 

LDA $1100,Y would load the accumulator from memory location 1100+3, or 
1103 

ACCUMULATOR | 78 | 

ADC $1105,Y would add the value 78 to the value in memory location 1105+ 
3, or 1108 (value is 01) 

ACCUMULATOR | 79 | 

STA $110B,X would store the value in the accumulator into memory location 
110B+6, or 1111 

MEMORY 1111 | 79 | 

The value for X and Y is originally loaded as zero. The Y value is incre¬ 
mented once each time through the loop, and the X register is incremented twice 
each time. Thus, a new value is loaded, a new value is added, and the result is 
stored in a new pair of locations. 


Y= 

Y= 

Loaded value 
from 

Added value 
from 

Result 
stored in 

0 

0 

1100 

1105 

110A and 110B 

1 

2 

1101 

1106 

110C and 110D 

2 

4 

1102 

1107 

110E and 110F 

3 

6 

1103 

1108 

IllOand 1111 

4 

8 

1104 

1109 

1112 and 1113 


A 

END OF PROGRAM 



Figure 8-4. How Memory is Used 


Now you are ready to use the computer with the Assembler Cartridge. 
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USING THE ADD FIVE PAIRS OF NUMBERS PROGRAM 

With the Assembler Cartridge in the left slot of the Atari, you might first 
input the program from the Edit mode. 


EDIT 

10 *=$1000 

20 LDY #0 
30 LDX #0 
40 LOOP CLC 
50 LDA $1100,Y 

60 ADC $1105,Y 

70 STA $110B,X 

80 BCC SKIP 

90 INC $110A,X 

100 SKIP INX 
110 INX 
120 INY 
130 CPY #5 

140 BNE LOOP 

150 END 


You then assemble the program. 


150 END 
ASM 


0000 


10 

*= 

$1000 

1000 

A000 

20 

LDY 

$0 

1002 

A200 

30 

LDX 

#0 

1004 

18 

40 LOOP 

CLC 


1005 

B90011 

50 

LDA 

$ 1100, Y 

1008 

790511 

60 

ADC 

$1105,Y 
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100B 

9D0B11 

70 

STA $110B,X 

100E 

9003 

80 

BCC SKIP 

1010 

FE0A11 

90 

INC $110A,X 

1013 

E8 

100 SKIP 

INX 

1014 

E8 

110 

INX 

1015 

C8 

120 

INY 

1016 

C005 

130 

CPY #5 

1018 

D0EA 

140 

BNE LOOP 



150 END 


EDIT 

■ 




Next, yoi 

j must plac 

;e the data ir 

i the appropriate tables. Notice that you 


are putting zeros in the result table. This must be done to make sure the loca¬ 
tions used for the high-order bytes of the result are filled with zeros originally. 
Since you are using the INCrement instruction to place the carry bit into the 
high-order byte of the result, you must make sure that a zero is in the memory 
to begin with. You must be in the Debug mode to enter the data. 



The DEBUG Command for changing values in memory is: 

CXXXX<yy where the X’s represent hexadecimal digits in the memory 
address to be changed. The y’s represent the one- or two- 
digit hex number to be placed in the specified memory 
location. 
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To change a number of consecutive memory locations the command takes 
the following form. 

CXXXX<aa,bb,cc,dd where XXXX is the first memory location to be 
changed. aa,bb,etc., represent hex values to be in¬ 
serted into consecutive memory locations starting 
at XXXX. Up to 16 data values may be inserted at 
one time. Then a new starting address is needed. 


DEBUG 

Cl 10(X12,34,56,78,9A,BC,DE,F0,1,23,0,0 j-Type in 16 
,0,0,0,0 -*—I codes 


DEBUG 

Cl 110C0,0,0,0 
DEBUG 


^ s - Then press RETURN 

-Press RETURN again 

after entering four 
more zeros 


There, the data is all in place, and the program has been assembled. As one 
final check, use the DISPLAY Command in the Debug mode to look at the pro¬ 
gram and the data. 

Display the program. 


DEBUG 
D1000,1019 


Program 


1000 A0 00 A2 00 18 B9 00 11 - -Eight values displayed 

1008 79 05 11 9D 0B 11 90 03 on each line 

1010 FE 0A 11 E8 E8 C8 CO 05 
1018 DO EA 


Check the hex codes against those on page 148. If they agree, then check 
the data. 
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DEBUG 
D1100,1113 


data tables 


1100 12 34 56 78 9A BC DE F0 
1108 01 23 00 00 00 00 00 00 
1100 00 00 00 00 


OK, now you can run the program. 


DEBUG 
G1000 
101A 
DEBUG 


A=BD X=0A Y=05 P=33 S=00 


Finally, check the results by displaying the result table. 


DEBUG 
D110A,110B 

110A 00 CE 

DEBUG 

D110C.110D 

110C 01 12 

DEBUG 

D110E.110F 

110E 01 46 
DEBUG 
D1110,1 111 

1110 00 79 

DEBUG 

D1112,1113 

111200 BD 
DEBUG 


12+BC = OOCE 


34+DE = 0112 


56+FO = 0146 


78+01 =0079 


9A+23 = BD 
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Suppose the sample problem changes. Instead of adding the ten numbers 
in pairs, you might want to add all ten numbers together. 


Sample Problem 2: Add ten two-digit numbers and store the result. 


Once again, expand Block B of the Functional Blocks of Figure 8-2. This 
time we want to: 


Block B 


1. Load the first 2-digit number 
into the accumulator. 

2. Add the temporary total 
(originally set to 0) 

and store the new temporary 
total. 

3. Load the next 2-digit number. 

4. Repeat steps 2 and 3 until 

all ten numbers have been added. 


Figure 8-5. Block B Parts— Add Ten Program 

Notice the differences between the solutions to Sample Problem 1 and 
Sample Problem 2. 


Solution to Sample 
Problem 2 


Solution to Sample 
Problem 1 


LOOP 


SKIP 


END 


LDY 

CLC 

LDA 

ADC 

STA 

BCC 

INC 

INY 


CPY 

BNE 


#0 --J 

LDY 

#0 

t 

LDX 

#0 

LOOP 

CLC 


$1100,Y 

LDA 

$1100,Y 

$110B -«-1_ ( 

ADC 

$1105,Y 

$11 OB -«-1 \ 

STA 

$110B,X 

SKIP 

BCC 

SKIP 

$110A 

INC 

$110A,X 

--v fSKIP 

INX 



INX 


) 

INY 


#0A { 

CPY 

#05 

LOOP 

BNE 

LOOP 

END 




You can see that the solution to Sample Problem 2 uses fewer instructions 
than the solution to Sample Problem 1. The temporary and final sum is stored in 
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memory locations 110A and 11 OB. The temporary sum is added to each two- 
digit number each time the loop is executed, and the new sum is stored back in 
the same location. For that reason, the X register is not needed in the second 
solution. 

This is how the memory locations are used as each two-digit number is 
added. 


Loop 

Number 

Accumulator 

Loaded 

Temporary 

Sum 

110A 

11 OB 

Stored 

1 

12 

00+12 

00 

12 

2 

34 

12+34 

00 

46 

3 

56 

46+56 

00 

9C 

4 

78 

9C+78 

01 

14 

5 

9A 

14+9 A 

01 

AE 

6 

BC 

AE+BC 

02 

6A 


etc. 

Figure 8-6. Memory Use in Add Ten Program 


USING THE ADD TEN PROGRAM 

The steps to use the program follow previous directions. We will not give 
the steps in detail, but we will show the results. 

In the Edit mode: 

1. Enter the Program. 

2. Assemble the Program. 

In the Debug mode: 

3. Load the data. 

4. Run the program. 

5. Display results. 
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1. Enter the Program. 

10 *=$1000 
20 LDY #0 

30 LOOP CLC 

40 LDA $1100,Y 

50 ADC $11 OB 

60 STA $11 OB 
70 BCC SKIP 
80 INC $110A 
90 SKIP INY 
100 CPY #10 — 

110 BNE LOOP 

120 END 


2. Assemble the program. 


,Note that we can enter the 
number of steps (10) as: 

#10 for decimal values 
or 

#$10 for hexadecimal values 
This indicates hex. 


'asm 

0000 

1000 

1002 

1003 

1006 

1009 

100C 

100E 

1011 

1012 

1014 


10 *= 

A000 20 LDY 

18 30 LOOP CLC 

B90011 40 LDA 

6D0B11 50 ADC 

8D0B11 60 STA 

9003 70 BCC 

EE0A11 80 INC 

C8 90 SKIP INY 

COOA.^^ 0100 CPY 

D0EC 0110 BNE 


$1000 

#0 


$1100,Y 
$110B 
$110B 
SKIP 
$110A 



#10 in decimal 

Assembled as a 
hex value, OA 


LOOP 


0120 END 
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3. Load the data in the Debug mode. 


BUG 

DEBUG 

C1100<12,34,56,78,9A,BC,DE,F0,1,23,0,0, 

>N -Data 

4. Run the program. 


( DEBUG 
G1000 

1016 A=5C X=00 Y=0A P=33 S=00 

5. Display the result. 

""debug 

D110A,110B 

110A 04 5C —. Result in locations 110A and 110B 

A VARIATION OF THE ADD TEN PROGRAM 


There is usually more than one way to program a solution to a problem, 
and a good programmer is continually seeking ways to make his programs more 
efficient. Let’s look at a slight variation of the last program that eliminates one 
two-byte instruction. 


THE TWO ADD TEN PROGRAMS 


First Program 


Second Program 

10 

*=$1000 


10 

*=$1000 

20 

LDY 

#o - —** 

*-*- 

20 

LDY 

#10 

30 

LOOP 

CLC 


30 

LOOP 

CLC 

40 

LDA 

$ 1100, Y 


40 

LDA 

$1100,Y 

50 

ADC 

$110B 


50 

ADC 

$110C 

60 

STA 

$ 110B 


60 

STA 

$110C 

70 

BCC 

SKIP 


70 

BCC 

SKIP 

80 

INC 

$110A 


80 

INC 

$110B 

90 

SKIP 

INY - - * 

**- ► 

90 

SKIP 

DEY 

100 

CPY 

#10 —* 

**~7 

100 

BNE 

LOOP 

110 

BNE 

LOOP omitted ' 

110 

END 


120 

END 



EE 

denotes program changes | 
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The second program counts downward from ten to zero as the loop is 
executed over and over. Because of this, the results and data tables are placed 
in slightly different memory locations. Each value is offset by one location. 

One instruction, CPY #10, is omitted from the second program. This is 
possible because the zero bit of the Processor Status Register is set when the Y 
register is decremented to zero after the last time through the loop. Therefore, 
the BNE instruction can be used directly following the DEY instruction with no 
comparison necessary. Since you were counting upwards from 0 through 10 in 
the first program, the value in the Y register had to be compared to ten before 
the BNE instruction could be used. 

A comparison of the assembled programs shows that the second program is 
two bytes shorter. It ends at memory location 1013, whereas the first program 
ended at memory location 1015. 

The data tables are accessed similarly for the two programs, but the mem¬ 
ory addresses are offset in the second program due to the way that the Y register 
is decremented. 


First Program 


r 






0000 


10 


$1000 


1000 

A000 

20 

LDY 

#0 


1002 

18 

30 LOOP 

CLC 



1003 

B90011 

40 

LDA 

$1100,Y 


1006 

6D0B11 

50 

ADC 

$110B 


1009 

8D0B11 

60 

STA 

$110B 


100C 

9003 

70 

BCC 

SKIP 


100E 

EE0A11 

80 

INC 

$110A 


1011 

C8 

90 SKIP 

INY 



1012 

C00A 

0100 

CPY 

#10 - 

this instruction 
unnecessary in 

1014 

D0ED 

0110 

BNE 

LOOP 

second program 


0120 END 





Figure 8-7. Data Tables 
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Naturally, executing the second program produces the same result as the 
first even though the numbers are added in the reverse order. 

One new instruction was introduced in the second program. 


DEY (DEcrement the Y register) 
Op Code 88 


It is a one-byte instruction used only in the Implied Addressing mode. It 
works just the opposite as INY (Increment Y). The value in the Y register is de¬ 
creased (or decremented) by one when the instruction is executed. 

Some programmers might object to the changes in the locations of the 
data tables. This change was done so that the branch instruction could make di¬ 
rect use of the condition of the zero bit following the DEY instruction. If the 
data was located as in the first program, the following sequence would result on 
the last pass through the loop. 


Old 

Y 

Instruction 

Executed 

Present 

Sum 

Memory 

Last 

A ccessed 

New 

Y 

1 

SKIP DEY 

04 4A 

1101 

V 

0 

BNE LOOP 

04 4A 




Sets zero bit in 
Processor Status 
Register 


Since the zero bit is set, the branch would not 
be taken back for the last number. Therefore, 
the final sum (044A) would be incorrect. 


YET ANOTHER VARIATION 


Another variation could be used to keep the data tables in their original 
position, but it would require that you change the order of the instructions and 
move the CPY instruction back into the program. 
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Third Program 


fw *=$1000 


20 

30 

40 

LDY 

LOOP 

CLC 

#10 

DEY -- 

Move DEY up here 

50 

LDA 

$1100,Y -- 

For Y values of 9,8,7, 

60 

ADC 

$110B. 

6,5,4,3,2,1,0 

70 

STA 

$110B^\ 


80 

BCC 

SKIP 


90 

INC 

$110A --- 

‘Back to original values 

100 

SKIP 

CPY#0^^^ 


110 

120 

BNE 

END 

LOOP ^ 

■CPY back in 


You can see that you have a considerable amount of freedom in designing 
a program. Any program is a good program if it solves the problem for which it 
was designed. Usually, good programs can be improved for efficiency and quick¬ 
ness of execution. Programming provides for large amounts of individualism and 
creativity. Enjoy it! 


SUMMARY 

In this chapter you’ve learned how to design an assembly language pro¬ 
gram to solve a specific problem. The suggested steps are: 

1. Analyze the problem by deciding how the solution will be accom¬ 
plished generally. 

2. Decide what memory locations will be used for data and results. 

3. Think through your solution in functional blocks. 

4. Expand each block into steps that the computer can handle. 

5. Write the program in terms of the expanded functional blocks. 

You learned how to handle data with tables accessed by the Absolute 
Indexed Addressing mode to load, add, and store data. Instructions 
used in this mode were: 

1. LDA $1100,Y Load data into the accumulator from memory (lo¬ 
cation 1100+the value in the Y register) 

2. ADC $1105,Y Add the data from memory (location 1105+the 
value of Y register) to the data in the accumulator 
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3. STA $110B,X Store the accumulator’s contents into memory (lo¬ 
cation 1 lOB+the value in the X register) 

4. INC $110A,X Increment the content of memory (location 110A+ 
the value in the X register) 

You learned to enter data with the change memory command in the 
Debug mode. 


Examples: 

Cl 10CK12,34,56,78,9A,BC,DE,F0,1,23,0,0 

, 0 , 0 , 0,0 \ 

'16 items entered consecutively starting at 
memory location 1100 
Cl 110C0,0,0,0 


^4 more items entered consecutively 
starting at memory location 1110 


• You learned that an index register can count down as well as up. 

Down -> DEY Decrement the Y register 

Up -*■ INY Increment the Y register 

• You learned to change a program to solve a new problem and to make 
variations of existing programs. 

• You learned that there may be several ways to program a solution to a 
given problem. 


EXERCISES 

1. In which mode (EDIT, ASM, or DEBUG) were the data entries loaded into 

memory for the programs in this chapter?_ 

2. What addressing mode is used for the following instruction? 

STA $1500,Y 


3. If the accumulator holds a value of 10, and the Y register holds 5, into what 
memory location will the 10 be stored if the instruction in Exercise 2 is 
executed? _ 
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4. The following values are in the computer as shown. 

Accumulator Memory | Data Y Register 



Then the following sequence of instructions is executed. Fill in the data in 
the appropriate blanks below. 

LDA $1100,Y 
ADC $1101,Y 
INY 

STA $1100,Y 



5. If the instructions of Exercise 4 were executed again using your results for 
Exercise 4, what would the new values be? 



6. Suppose you are in the Debug mode, and you execute the command: 
Cl 100<A4,F3,C5,19 

Show what would be in the following memory locations. 



Hint: One of the memory locations is 
not changed by the command. Place 
an XX in that location. 
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7. Give one DEBUG command to display all four memory locations of Exercise 


8. Fill in the blanks in the table below for the following program. 

10 *=$1000 
20 LDY #0 

30 LOOP CLC 

40 LDA $1101,Y 

50 ADC $1100,Y 

60 INY 

70 ST A $1100,Y 

80 CPY #4 
90 BNE LOOP 

100 END 


End of 
Loop 

Register 

Accumulator 

Memory 

1100 

1101 

1102 

1103 

1104 

0 

0 

00 

01 

02 

03 

04 

05 

1 








2 








3 








4 









9. Show the hex and decimal values for the following Assembler notations. 

#24 -hex = -decimal 

#$24-hex = _decimal 


ANSWERS 


1. DEBUG 

2. Absolute Indexed Addressing 

3. 1505 (hex) 

4. Accumulator 

s 


Memory 

Data 

1101 

D5 

1101 

33 

1102 

55 

1103 

24 


Y Register 


H 
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5. Accumulator 

H 


Memory 

Data 

1100 

1101 

1102 

1103 

1104 

A4 

F3 

C5 

19 

XX 


7. Dll00,1103 


Memory 

Data 

1100 

D5 

1101 

33 

1102 

55 

1103 

79 


(don’t know) 


Y Register 

H 


At End 

of loop # 

Y 

Register 

Accumulator 

Memory 

1100 

1101 

1102 

1103 

1104 

0 

0 

00 

01 

02 

03 

04 

05 

1 

1 

03 

01 

03 

03 

04 

05 

2 

2 

06 

01 

03 

06 

04 

05 

3 

3 

0A 

01 

03 

06 

0A 

05 

4 

4 

OF 

01 

03 

06 

0A 

OF 


9. #24 18 hex = 24 decimal 

#$24 24 hex = 36 decimal 
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Addition and Subtraction 


You are now familiar with the way that computers add and subtract num¬ 
bers. Since the size of registers and memory is limited to 8 binary digits, addition 
and subtraction must be performed with pieces of data of the same size. Keep in 
mind that the largest decimal integer that can be expressed in 8 bits (one byte) is 
255. 

You learned in Chapter 6 to test for the Carry bit to see if the sum of two 
8-bit numbers was larger than the accumulator could hold. 


Example: 

hex 

7D 

+A4 

121 


binary 

01111101 

+10100100 


--sum in the accumulator 


extra bit 

sets the Carry flag 


In this way you can tell when the sum of two 8-bit numbers is larger than can be 
held in a register or memory location. However at some time you will want to 
add numbers that are larger than 255. To accomplish this, the computer must 
handle the number in more than one byte. The computer can add a byte from 
each of two numbers, store the result, and then add the second bytes of the two 
numbers. Then you can display the two parts as one complete number. 
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Example: 

hex binary 


6E61 
+219C 
8FFD 


0110111001100001 

+0010000110011100 



add these bytes 
first and store 


then add these bytes and 
store in different location 


11111101 | 
FD 

10001111 | 


The complete result is 8FFD 


8F 


TWO-BYTE ADDITION 


A paper-and-pencil addition of two-byte numbers will help us decide how 
to write a program to perform the operation on the computer. Suppose we want 
to add these two-byte hex numbers. 


55A4 = 
+3CB3 = 



01010101 10100100 
00111100 10110011 


Least Significant 
Byte 


The binary addition 01010101 10100100 
by bytes -+ +00111100 10110011 +- LSB first 

1 01010111 

Extra Least Significant Byte (LSB) 
is in the of result 
Carry bit 

Then MSB 01010101 10100100 
+00111100 10110011 

+_L 01010111 +- from LSB 

10010010 


Most Significant Byte (MSB) 
of result 
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MSB LSB 

The final result = 10010010 01010111 

W ' 


w 


HEX 


Notice that in this example a carry results from the addition of the Least Signifi¬ 
cant Bytes. The ADC (ADd with Carry) instruction will automatically add in this 
carry bit to the sum of the Most Significant Bytes. Therefore, it appears that the 
two-byte numbers are summed by adding first, the Least Significant Bytes and 
second, the Most Significant Bytes. 


1. Add and store the 
least significant bytes 


2. Add and store the 
most significant bytes 


Figure 9-1. Functional Blocks for A ddition 


It looks like a very straightforward program. Set up a block of memory to 
store the bytes that are to be added and the bytes of the result of the addition. 
Since there are two bytes for each number, set aside 6 bytes. 


Memory 

location 

I 

1100 

1101 

1102 

1103 

1104 

1105 


Value 

I 

LSB of 1st number 
MSB of 1st number 
LSB of 2nd number 
MSB of 2nd number 

MSB of result ~l The order of 

LSB of result J the result is 

reversed for 
convenience of 
display 


Figure 9-2. Storage for Two-Byte Addition 


The first two-byte number to be added is stored in memory location 1100 
(Least Significant Byte) and 1101 (Most Significant Byte). The second number is 
stored in memory location 1102 (Least Significant Byte) and 1103 (Most Signifi¬ 
cant Byte). These values must all be loaded before the program is executed. You 
know how to do this in the Debugger mode. 
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Break down the functional blocks into detailed steps and use the mnemonic 
instructions that you have become familiar with. 



Block 2 LDA$1001 -*— Load MSB of first number 

ADC $1003 -*— Add MSB of second number 
STA $1004 -*— Store accumulator into 
_ appropriate memory location 


Figure 9-3. Detailed Steps for Functional Blocks 


One thing that you must remember about the ADC instruction is that the 
Carry bit (if set) is added to the sum. When you add the Least Significant Bytes, 
you must be sure that the carry bit is off (reset to zero). Therefore, a CLC (Clear 
Carry bit) is needed before the Least Significant Bytes are added. 

If you draw a flowchart of the operations that must be performed it will 
help you write the program step by step. 



Figure 9-4. Flowchart for Two-Byte Addition 


END 





168 ADDITION AND SUBTRACTION 


If a program is short, like this one, and you have a detailed flowchart, as 
in Figure 9-4, you can write the program directly from the flowchart in the 
Writer/Editor mode. 


EDIT 

NUM 100,10 


100 

*=$1000 

110 

CLC 

120 

LDA $1100 

130 

ADC $1102 

140 

STA $1105 

150 

LDA $1101 

160 

ADC $1103 

170 

STA $1104 


- Number lines from 100 in 
steps of 10 


- Clear carry for adding LSB 


- A carry may be added to MSB 

- Press RETURN to exit 


Notice that LDA, ADC, and STA are all used in the Absolute Addressing 
mode this time. You can use that mode since you know exactly where each 
piece of data is in memory or where you wish to put it in memory. 

Once the program has been entered, assemble it. 


180 END 



0000 100 
1000 18 110 

1001 AD0011 120 

1004 6D0211 130 

1007 8D0511 140 

100A AD0111 150 

100D 6D0311 160 


Type: ASM 

*= $1000 
CLC 

LDA $1100 
ADC $1102 
STA $1105 
LDA $1101 
ADC $1103 
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1010 8D0411 170 STA $1104 

180 END 

EDIT 


Now, the program is assembled. It resides in memory locations 1000 
through 1012. Don’t forget the data. Use the data shown in the paper-and-pencil 
example so that you can check the results: 

55A4 

+3CB3 

9257 

Place the four pieces of data in the four specified memory locations. 


LSB 1st number 
MSB 1st number 
LSB 2nd number 
MSB 2nd number 

Figure 9-5. Data Used in Example 

You are now ready to go to the Debugger mode to enter the data into the 
memory locations shown in Figure 9-5. Remember how to do it with the Change 
Memory command? 


All four pieces in 
consecutive memory 
locations 

Now execute the program and display memory locations 1104 and 1005 
to see the sum. 
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DEBUG 

C1100<A4,55,B3,3C 

G1000 -*-Execute 


1013 A=92 X=00 Y=00 P=32 S=00 

DEBUG 

D1104,1105 --Display result 


1104 92 57 
DEBUG 


Correct 


Before leaving the Two-Byte Addition Program, try adding the pairs of 
numbers given in Figure 9-6. Use the Change Memory command to put the 
numbers in memory. Place your answers in the appropriate boxes in Figure 
9-6. Check your results against the answers given in the answers to chapter 
exercises. 


First 

Number 

Second 

Number 

Sum 

000A 

000B 


13C5 

0F24 


6666 

333E 


37AB 

A09D 


El 11 

2000 



Figure 9-6. Two-Byte A ddition Exercises 


Beware of the last exercise in Figure 9-6. Can you tell what result will be 
displayed after the program has been executed? 

TWO PROGRAMS IN MEMORY 

Suppose you wish to have an addition program and a subtraction program 
in the computer at the same time. Only three changes are necessary to convert 
the addition program now in the computer, to a two-byte subtraction program. 
It would be time consuming to rewrite the program, but you can quickly copy 
the addition program to a different block of memory with the DEBUGGER’S 
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Move command. Then you can modify the original addition program to perform 
subtraction instead. 

You have probably noticed that a BRK instruction (Op Code 00) is inserted 
at the end of each program when it is assembled. The END statement of the 
Source Program creates the BRK statement. The BRK instruction should be in¬ 
cluded as you move the original program. 


1000 

18 

1001 

AD 

1012 

11 

1013 

00 



1020 

18 

1021 

AD 

1032 

11 

1033 

00 


Original addition program 


Move original program 
to these locations 


If you don’t remember how to use the Move command, see Chapter 6 or 
follow this procedure: 


r. - 

1104 92 57 «- Answer from addition 

DEBUG 

M1020<1000,1013 <- Move 

DEBUG 
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Verify that the two programs are the same before going on to be sure that 
the move was made correctly. 



Now, you’re ready to change the original program so that it will subtract 
instead of add. 

TWO-BYTE SUBTRACTION 

Subtraction of two-byte numbers is performed in a similar manner. The 
Two-Byte Addition Program can be modified by three minor changes: 

• At memory location 1000: 

change 18 (CLC) to 38 (SEC) <- Set the carry bit instead of clearing it 

• At memory locations 1004 and 100D: 

change 6D (ADC) to ED (SBC) *- Subtract with borrow instead of add 
with carry 

The change at 1000 sets the carry bit in preparation for the subtraction 
just as it did the One-Byte Subtraction Program of Chapter 4. The add with 
carry instruction (ADC) is replaced by the subtract with borrow (SBC). The 
subtract instruction is used in the Absolute Addressing mode. The address which 
contains the number to be subtracted follows the Op Code, as it followed the 
ADC instruction in the addition program. Thus, the Least Significant Byte of the 
value to be subtracted is contained in address 1102. The Most Significant Byte 
of the value to be subtracted is contained in address 1103. 

The changes: 
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You now have two machine language programs in the computer. The Two- 
Byte Addition Program was assembled starting at location 1000 but was moved 
to 1020 through 1032. The Two-Byte Subtraction Program is now in locations 
1000 through 1013. You can now use either program by choosing the correct 
memory address for the G command which executes the program starting at the 
location that you specify. 

Before you execute either program, put the original numbers (55A4 and 
3CB3) back into memory locations 1100 through 1103. 



You can now use either program. 
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Check the subtraction with paper and pencil to make sure that the subtrac¬ 
tion result is correct. We hope you like birfery subtraction. There are lots of 
borrows. 


55A4 = 
-3CB3 = 


0101 0101 1010 0100 

oon noo ion ooli 

0001 1000 1111 0001 binary 



Yes, it checks 


Try the subtraction exercises in Figure 9-7. Watch the result of the last 
two exercises in the table. Can you explain the results? 


First 

Number 

Last 

Number 

Difference 

FFFF 

0112 


76A3 

6DCB 


590A 

3A1B 


2222 

3333 


0000 

0004 



Figure 9-7. Two-Byte Subtraction Exercises 

The problem involved with the last two exercises in Figure 9-7 is that you 
are trying to subtract a positive number from a smaller positive number. 

2222 and 0000 
-3333 -0004 

Algebra students know that the result of each of these exercises is a negative 
number. You actually saw these results displayed on the screen. 

EEEF and FFFC 

This means that a method must exist to determine whether a number is positive 
or negative. 

NEGATIVE NUMBERS 

It is possible to look at the way data is represented in the computer in a 
different way. If signed numbers (those that are either positive, negative, or 
zero) are to be represented, the computer must have some way to tell them apart. 

Consider an 8-bit block of data as being composed of one sign bit and 
seven data bits. 
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1. If the sign position holds a zero, the data is considered to be a positive 
number. 

Examples: 

01111111= +127(64+32+16+8+4+2+1) 
01111110= +126(64+32+16+8+4+2 ) 

0 1 1 1 1 1 0 1 = +125 (64+32+16+8+4 +1) 
01111100= +124(64+32+16+8+4 ) 


00000011= +3 ( +2+1) 

00000010 = +2 ( +2 ) 

00000001 = + 1 ( + 1 ) 

00000000 = + 0 ( ) 
\ 


Zero is considered a positive 
number by Branch Instructions 

2. If the sign position holds a one (1), the data is considered to be a nega¬ 
tive number. 

Examples: 

1 0000000 = -128 
1 0 0 0 0 0 0 1 = -127 

1 0 0 0 0 0 1 0 = -126 

1 0 0 0 0 0 1 1 = -125 

1 0 0 0 0 1 0 0 = -124 


1 1 1 1 1 0 1 1 = -5 
1 1 1 1 1 1 0 0 = -4 
1 1 1 1 1 1 0 1 = -3 
1 1 1 1 1 1 1 0 = -2 
1 1 1 1 1 1 1 1 = -1 
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We have learned to interpret positive binary numbers as positive decimal 
numbers, but what about these negative critters? They don’t look familiar at all. 
However, it is plain to see that each 8-bit code could represent all the integers 
from -128 through +127. 


00000000 

00000001 


01111110 

01111111 

10000000 

10000001 

10000010 


11111110 

11111111 


+0 

+1 


+126 

+127 

-128 

-127 

-126 


positive 


negative 



Zero and 

above 

positive 


s 


| below zero 
j negative 


Let’s take a look at the negatives and see if there is any meaningful rela¬ 
tionship to their positive counterparts. 

Consider the positive number 126 = 01111110. 

Its one’s complement = 10000001 

Its two’s complement = 10000010 

Compare the latter with -126 = 10000010 

The binary representation of a negative number (-1 through -127) is equal to 
the two’s complement of its positive counterpart. 

-1 27 = the two’s complement of +1 27 
-126 = the two’s complement of +126 
-125 = the two’s complement of +1 25 

-2 = the two’s complement of+2 

-1 = the two’s complement of+1 

Therefore, you can interpret the form of the results of the last two exam¬ 
ples in Figure 9-7 by converting the displayed results as follows: 
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1. 2222 
-3333 

EEEF hex = 1110 1110 1110 1111 binary 

take the one’s 

complement 0001 0001 0001 0000 

add one for the 

two’s complement 0001 0001 0001 0001 

Therefore, EEEF hex = negative 1111 hex 
2. 0000 
-0004 

FFFC hex = 1111 1111 1111 1100 binary 

one’s 

complement 0000 0000 0000 0011 

two’s 

complement 0000 0000 0000 0100 

Therefore, FFFC hex = negative 0004 hex 

When thinking in terms of signed two-byte hex numbers, all numbers from 
8000 through FFFF are considered negative. All two-bytes hex numbers from 
0000 through 7FFF, are considered positive. 


Figure 9-8. Two-Byte Hex 
Signed Numbers 


Unsigned 




0001 

0002 

0003 


+0001 

+0002 

+0003 


7FFD 

7FFE 

7FFF 


+7FFD 

+7FFE 

+7FFF 


8001 

8002 

8003 


-7FFF 

-7FFE 

-7FFD 


FFFD 

FFFE 

FFFF 


-0003 

-0002 

-0001 


Positive 


Negative 
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For two-byte numbers, the sign position is considered to be in the Most 
Significant Bit of the Most Significant Byte. 


Most Significant Byte 
7 6 5 4 3 2 1 0 

M I N I M I 




Sign- 

position 


Least Significant Byte 
7 6 5 4 3 2 1 0 

• MINIM 


Thus numbers such as: 

0000000000010000 = 0010 hex 
0010011111100110 = 27E6 hex 
0110111110101001 = 6FA9 hex 

would be interpreted as positive numbers, but numbers such as: 

1000000000000000 = 8000 hex 
1010011111100101 = A7E5 hex 
1111011010111100= F6BC hex 

would be interpreted as negative numbers. 

A complete discussion of the arithmetic of signed numbers is beyond the 
scope of this book. A more thorough discussion of signed numbers and signed 
number arithmetic can be found in the MOS Technology Programming Manual 
available in some computer stores or from MOS Technology, Inc., 950 Ritten- 
house Road, Norristown, PA 19401. 

For our purposes, we must realize that certain branch instructions test the 
result of numbers to see whether they are negative or positive. This determina¬ 
tion depends on whether or not the Negative flag of the Processor Status Regis¬ 
ter has been set to 1 or not. The Negative flag is set to 1 when the computer 
interprets the results of certain instructions as negative numbers (a 1 in bit 7 
resulting from the operation performed by the instruction). In Chapter 5, a table 
shows the effect that each instruction has on the various flags in the Processor 
Status Register. 


MULTIPLE-BYTE ADDITION AND SUBTRACTION 

To add or subtract numbers that require more than two bytes, an exten¬ 
sion of this two-byte procedure can be made. The operation is always performed 
from the Least Significant Byte forward (or from right to left). 
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vS* 




Figure 9-9. Multiple-Byte Addition Flowchart 


DECIMAL ARITHMETIC 

Are you tired of converting binary to hex to decimal? If so, the 6502 in¬ 
struction set includes an instruction to help you out. If you are careful to ex¬ 
press the values that you wish to add or subtract as binary-coded-decimal (BCD) 
numbers, the Atari can add or subtract those numbers and express the result as a 
decimal value. What are binary-coded decimal numbers? That’s just a fancy name 
for a binary number that has been separated into two 4-bit parts. These parts are 
then interpreted as decimal digits. 


Examples: 


Binary 

Binary-coded-decimal 

Decimal 

01011000 

0101 1000 

58 

10010011 

1001 0011 

93 

00010110 

0001 0110 

16 
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Since each four bits is interpreted as a decimal digit, the binary inputs 
must be chosen with care. 

11001001 = 1100 1001 

*-NOT a BCD value 

10101011 = 1010 1011 

^-*-NOT BCD values 

Each 4-bit part must be one of these: 


BCD 

DECIMAL 

0000 

0 

0001 

1 

0010 

2 

0011 

3 

0100 

4 

0101 

5 

0110 

6 

0111 

7 

1000 

8 

1001 

9 


The instruction needed to request the computer to perform decimal addi¬ 
tion or subtraction is: 

SED (SEt Decimal mode) 

Op Code = F8 

Implied Addressing mode 
One byte long. 

Status flags affected: D 

This instruction sets the Decimal flag in the Processor Status Register to 1. 

/-Decimal flag 

/ set to one 


Processor Status Register 
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Once this instruction has been used, all of the Add and Subtract instruc¬ 
tions will be carried out as decimal operations because of the status of the Deci¬ 
mal flag. The operation of any of the other instructions are not affected. If the 
SED instruction has been executed in a program, and a binary addition or sub¬ 
traction is desired, the computer must execute the Clear Decimal mode instruc¬ 
tion. 


CLD (CLear Decimal mode) 
Op Code = D8 

Implied Addressing mode 

One byte long 

Status flags affected: D 


This instruction resets the decimal flag in the Processor Status Register to 

zero. 

Suppose that you want to add the decimal numbers 18 and 23. You might 
use this program. 


ADD TWO DECIMAL NUMBERS 


SED 

CLC 

LDA$1000 
ADC$1001 
STA $1100 


Set decimal mode 
Clear the carry bit 

Load accumulator from memory location $1000 
Add value from memory location $1001 
Store the sum 


Enter and assemble: 


EDIT 

NUM 100,10 

100 *=$1000 +- Enter it 

110 SED 

120 CLC 

130 LDA $1100 

140 ADC $1101 

150 STA $1002 

160 END 

170 

ASM ■*- Assemble it 


0000 


100 *=$1000 
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1000 F8 110 SED 

1001 18 120 CLC 

1002 AD0011 130 LDA $1000 

1005 6D0111 140 ADC $1001 

1008 8D0211 150 STA $1002 

160 END 

EDIT 


Go to the DEBUGGER, execute the program, and display the result. Be sure to 
load the data in 1100 and 1101 first. 



The decimal result of 18+23 is 41. If we had been adding the hexadecimal 
values of 18 and 23, the result would have been 3B. Remember, 18 and 23 in 
hexadecimal notation are different values than 18 and 23 in decimal notation. 


3B hex and 41 decimal are not equivalent valui 


Now let’s execute the program starting from location 1001 (omitting 
the Set Decimal instruction) and observe the result. 
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DEBUG 

G1001 

10OB A=41 X=00 Y=00 P=38 S=00 

DEBUG 

Dll 02,1102 

1102 41 ___Same result 

debug"* ' 


Once the SED instruction has been executed, all additions in the program 
are performed in the decimal mode. The CLD (Clear Decimal mode) in¬ 
struction must be executed to get back to binary addition. 


The advantage of decimal addition is that it relieves you of converting 
numbers from one base to another for interpretation. You can enter decimal 
values (such as 23 and 18) and obtain decimal results (41). 

Try the Add Two Decimal Numbers Program with other pairs of decimal 
values. Substitute them for the values that you originally put in memory loca¬ 
tions 1100 and 1102. Use the Change Memory command to input the values in 
Figure 9-10. 

The first change would be: 


r. 

C1100<51,23 


First 

Number 

Second 

Number 

Sum 

Displayed 

51 

23 


68 

14 


29 

17 


33 

99 


72 

45 



Figure 9-10. Decimal A ddition Exercises 
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What is wrong with the last two exercises in Figure 9-10? Make sure that 
the sum of the two numbers is less than 100 in this program. Any sum whose 
value is greater than 99 will not fit in the accumulator or any memory location. 
Remember, this is an 8-bit computer. Here is what will happen to you if you in¬ 
sist on experimenting (we secretly encourage you). 

Last exercise example: 


Load data 
Execute 


Display result 

You know it means 117, 
but it just can’t show 
all of it 

Since the 6502 microprocessor handles blocks of data in 8-bit sizes, some 
provision must be made for the situation which results when a sum is larger than 
can be held in 8 bits. This technique was shown in earlier chapters with hexa¬ 
decimal arithmetic. The same method will work with decimal addition and sub¬ 
traction. 


SUMMARY 

In this chapter you have learned: 

• To break large numbers into more than one byte in order to perform 
two-byte arithmetic, 

• To retrieve, add (or subtract), and store separate bytes of two-byte 
numbers using the Absolute Addressing mode, 

• How the carry flag is used for two-byte addition and subtraction, 

• How to move blocks of data from one area of memory to another, 

• How signed numbers may be interpreted: 

negative if Most Significant Bit is set to 1 
positive if Most Significant Bit is reset to 0, 

• The significance of the status flags on the Processor Status Register for 
branch instructions, 

• That addition and subtraction can be performed on numbers larger than 
two bytes, 
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To write numbers in binary-coded-decimal (BCD) form so that the com¬ 
puter can perform decimal addition and subtraction, 

How to use the Set Decimal mode and Clear Decimal mode to perform 
either decimal or binary arithmetic. 


EXERCISES 

1. If the two-byte hex numbers 9B and 66 are added, will the sum be too large 

to be held in the accumulator? _ 

2. Tell how the computer will handle the sum in Exercise 1. 

(a) Number in accumulator- 

(b) The Carry flag will be_ 

(zero, one) 

3. The following data is stored (or to be stored) in the specified memory loca¬ 
tions. 


*- Put sum here 

Give the assembly language instructions to load the number from address 
1110, add the number from address 1111 and store the result using the Abso¬ 
lute Addressing mode. 

(a) - 

(b) - 

(c) - 

4. In performing an addition or subtraction operation on the Least Significant 
Bytes, the Carry flag must be appropriately set or reset. The assembly instruc¬ 
tion: 

(a) for addition is- 

(b) for subtraction is _ 

5. Show where the data would be placed by the following instruction. 

Cl 120<15,A4,32,CC 
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6. Write the DEBUGGER command that would move the data from where it is 
in memory in Exercise 5 to memory block 1105 through 1108. 


7. Tell whether the following signed numbers would be interpreted as negative 
or positive. 

(a) 10100111 binary _ 

(b) 7F hex_ 

(c) 01011111 binary_ 

(d) A3 hex _ 

8. Two-byte signed numbers are considered: 

(a) positive if in the range of- through- 

(b) negative if in the range of- through-- 


ANSWERS 


Figure 9-6 


First 

Second 

Sum 

Number 

Number 


000A 

000B 

0015 

13C5 

0F24 

22 E9 

6666 

333E 

99A4 

37AB 

A09D 

D848 

El 11 

2000 

0111 

Figure 9-7 

First 

Last 

Difference 

Number 

Number 


FFFF 

0112 

FEED 

76A3 

6DCB 

08D8 

590A 

3A1B 

1EEF 

2222 

3333 

EEEF 

0000 

0004 

FFFC 


Most Significant Bit is lost 


Last two are negative results 
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Figure 9-10 


First 

Number 

Second 

Number 

Sum 

Displayed 

51 

23 

74 

68 

14 

82 

29 

17 

46 

33 

99 

32 

72 

45 

17 


1. yes 


2. (a) 01 

(b) one (true answer is 101) 

3. (a) LDA $1110 

(b) ADC $1111 

(c) STA $1112 

4. (a) CLC 

(b) SEC 


5. 


Address 

Data 

1120 

15 

1121 

A4 

1122 

32 

1123 

CC 


Most Significant Bit is 
lost in last two answers 


6. Ml 105<1120,1123 

7. (a) negative 

(b) positive 

(c) positive 

(d) negative 

8. (a) 0000 through 7FFF 
(b) 8000 through FFFF 
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Shift and Rotate 


You learned to add and subtract in Chapter 9, but these two operations 
are only half of the four basic arithmetic operations. What about multiplication 
and division? The 6502 microprocessor has no instructions that will directly 
perform multiplication and division. However, think of the way that you per¬ 
form these operations with pencil and paper. 

You perform a series of additions, subtractions, and shifts to get the 
partial answers into the correct place value. 

Examples: 

(a) Multiplication 

23 

x32 

46 •* -1) Two 23’s = 23+23 = 46 

69 -2) Shift one place left 

--3) Three 23’s = 23+23+23 = 69 

736 4) Add 46+69 = 736 

(b) Division 

32 

23) 736 

69 ^— 1) Three 23’s = 23+23+23 = 69 
'*'^2) Subtract 

46-<—3) Shift right and bring down 

46^— 4) Two 23’s = 23+23 = 46 
0-*—5) Subtract 

You know that the computer can add and subtract, but you must learn 
how to manipulate numbers with instructions that will shift the numbers left 
or right before you tackle the multiplication and division operations. 

Let’s take another look at the structure of 8-bit binary numbers so that 
you can better understand the consequences of changing place values. 


188 
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2 . 

Shifted 

3. 

Shifted 

4. 

Shifted 


Binary 
00000111 


/// 


00001110 

Binary 

00010010 


/ / 

00100100 


Binary 

01101001 


Hex 

7 

E 

Hex 

12 

24 

Hex 

69 

D2 


Decimal 

7 

14 

Decimal 

18 

36 

Decimal 

105 

210 


From the previous examples, you can see that a shift of one place to the 
left doubles the value of an 8-bit number. In the decimal paper-and-pencil multi¬ 
plication and division examples, you made shifts which changed the place values 
by powers of ten. 

23 
x 32 

46 -«-2 x 23 

69 -+ -shift left a power of ten because 3x 23 is really 30x 23 

736 


In binary multiplication: 

101 
x 11 

101 -*-1 x 101 

101 Shift left a power of two because 

1111 1 x 101 is really 10 x 101 

You really do it in two parts 

101 101 

x 1 xIO 

101 + 1010 = 1111 


The shifting is just a short cut to perform separate operations as one unit. 


In this chapter, we will describe the four shift and rotate instructions 
in the 6502 instruction set. We will also use subroutines, short mini-programs 
that can be branched to from several different locations. 

First, we will demonstrate how the shift and rotate instructions work 
and then show some applications. 
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The four instructions are: 

1. ASL (Arithmetic Shift Left), 

2. LSR (Logical Shift Right), 

3. ROL (ROtate Left), and 

4. ROR (ROtate Right). 

ARITHMETIC SHIFT LEFT 

The first instruction that we will look at is ASL. This instruction shifts 
every bit in a particular byte of data one position to the left, as we have been 
discussing in previous examples. 

One thing we didn’t discuss earlier. If the 8 bits are shifted left, what hap¬ 
pens at each end? 



The 2° bit goes to 2 1 

2 1 bit goes to 2 2 

2 2 bit goes to 2 3 

2 3 bit goes to 2 4 

2 4 bit goes to 2 s 

2 s bit goes to 2 6 

2 6 bit goes to 2 7 

But where does the 2 7 bit go, and where does the 2° bit come from? 

Each time that the ASL instruction is executed, the Carry flag assumes the 
value that was in the leftmost bit (2 7 ) before the shift occurred. All the rest of 
the bits are moved left one position, and a zero is moved into the rightmost 
position (2°). 



□ 


Carry flag 

Here is an example that shows the contents of the accumulator before, 
during, and after the instruction is executed. The value, B1, is in the accumula¬ 
tor before execution. 
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0 

Carry bit 


Figure 10-2(a). Before ASL 


Accumulator 



Carry bit 


Figure 10-2(b). This Is What Happens 



Carry bit 


Figure 10-2(c). After ASL 


Enter the following short little program, and you can see the computer 
shift the value in the accumulator when the ASL instruction is executed. The 
program places a one in the accumulator and shifts it left one place. 
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Assemble the program. 



Now, enter the DEBUGGER and set the accumulator to zero by using the 
Charge Register command. 



Trace the program by typing: TIOOOand pressing the RETURN key. 


T1000 

1000 18 CLC 

A=00 X=00 Y=00 P=32 S=00 

1001 A9 01 LDA #$01 

A=01 X=00 Y=00 P=30 S=00 

1003 OA ASL A 

A=02 X=00 Y=00 P=30 S=00 

1004 00 BRK 

A=02 X=00 Y=00 P=30 S=00 


Accumulator 

00000000 

00000001 

00000010 


Now 

shifted 


DEBUG 
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/, reset the accumulator to zero before going on to the next program. 


You only shifted left one time in the previous program. What happens if 
you shift left 8 times in succession? Would there be anything left in the accumu¬ 
lator? What would be the condition of the Carry flag? Try it. 

Enter the program shown below and assemble it. 

010 *=$1000 
020 CLC 

030 LDA #1 

040 ASL A x 

050 ASL A ] 

060 ASL A f 

070 ASL A > 8 Left shifts 

080 ASL A l 

090 ASL A ] 

100 ASL A ' 

110 ASLA 
120 END 


This program sets the carry bit to zero, puts a 1 in the accumulator, and shifts 
the accumulator left 8 times. When the program is done, the accumulator should 
be zero and the Carry flag should be set, because the bit which forms the 1 in 
the accumulator was shifted left through every bit and then out of the accumula¬ 
tor and into the Carry bit. To see this for yourself, type “BUG” and press RE¬ 
TURN. Then type “DR” and press RETURN again. You should see the registers 
as they are below. 



Processor Status Register = 30 hex 
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Now, execute the program by typing: G1000, and press the RETURN key. 
You should see the following: 


DEBUG 

G1000 

100B A=00 X=00 Y=00 P=33 S=00 

DEBUG 


The Processor Status Register has changed, and the Carry flag (bit 0) is set. 

/ Carry bit 

| 0 0 1 1 0 0 1 1 | 

Processor Status Register = 33 hex 


Now try typing “T1000” to Trace the program. You will be able to see the regis¬ 
ters as they are changing after each step in the program. Be sure to press RE¬ 
TURN after typing “T1000”. 


DEBUG 
T1000 
1000 
A=00 
1001 
A=01 
1003 
A=02 
100 4 
A=04 

1005 
A=0fl 

100b 

A=10 

1007 

A=50 

1006 
A=M0 

100T 
A=60 
100 A 
A=00 
100B 
A=00 


16 

X=00 V=00 
AT 01 
X=00 Y=00 
0 A 

X=00 Y=00 
0 A 

X=00 Y=00 
0 A 

X=00 Y=00 
0 A 

X=00 Y=00 
0 A 

X=00 Y=00 
0 A 

X=00 Y=00 
0A 

X=00 Y=00 
0 A 

X=00 Y=00 
00 

X=00 Y=00 



P—32 S-00 ^^V~Carry Cleared\ 

LDA #$01 
P=30 S=00 Oif , 

ASL A 
P=30 S=00 
ASL A 
P=30 S=00 
ASL A 
P=30 S=00 
ASL A 
P=30 S=00 
ASL A 
P=30 S=00 
ASL A 
P=30 S=00 
ASL AQ n 



Accumulator 

I oooodooi~| 
I 00000010| 
I oooootWI 
I ooooToool 
I oooiooool 
I 001000001 
I 01000000 | 
I 100000001 
^- 1 ooooooool 

m 

Carry 


Figure 10-3. Trace of the Shift Program 
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After the first instruction of the program (CLC) is executed, the Processor 
Status Register (P register) shows a value of 32. This means the Carry flag is 
zero. If a carry had occurred, the P register would read 33. Note that the Zero 
flag (bit 1 of the P register) is set. 


| 0 0 1 1 0 0 1 0 ] 

v \_- Carry flag 

'-Zero flag 

P Register after CLC Instruction 

After the next step (LDA #$01), which loads the 1 into the accumulator, 
the A register = 01 and P=30, indicating that when the 1 (a non-zero value) was 
loaded, the Zero bit was turned off. 


|o 0 0 0 0 0 0 i] | 0 0 1 1 0 0 0 0~| 

A Register P Register 

• Note the pattern in the accumulator after each left shift. As the original 
1 is shifted, the value in the accumulator is effectively doubled. 

• Notice that when the value of 80 was in the accumulator, the P register 
changed to BO. When a value greater than 7F results from a shift, the 
Negative flag (bit 7 of the P register) is turned on. As you found out 
earlier in the book, the computer considers any number with its 7th bit 
on (all hex numbers between 80 and FF) as negative for comparing pur¬ 
poses (such as those used by branches). 

After the last shift instruction is performed, the A register becomes zero 
and the bit that formed the value of 80 has been moved over to the Carry bit of 
the P register. The Negative flag is off (since the A register is zero). This leaves 
the P register with its Carry and Zero bits set to 1. 

looooooool 1 0 0 1 1 0 0 1 T~1 

A Register P Register 

As we mentioned earlier, shifting a number left has the effect of doubling 
that number. This can be used to make a simple multiplication program. This 
program can only multiply a number by a multiple of two, though. If you want 
to multiply a number by 2, shift it once. You shift it twice to multiply by 4, 
three times for 8, etc. The program shown below is an example of multiplying 
8 by 4. Enter the program and assemble. 
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The accumulator now holds the number 20 (hex), which is the same as 32 in 
decimal, 8x4=32, right? 

You have to be careful when you multiply numbers this way, though, be¬ 
cause if you have a number like 80 (hex), and you try to multiply it by 4 by 
shifting it left twice, you are going to get an answer of zero in the accumulator 
and the Carry bit. 



Carry bit Carry bit 

Figure 10-4(a). Original Value Figure 10-4(b). After One Shift 


Accumulator 



Figure 10-4(c). After Two Shifts 
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We have used the ASL instruction in the Accumulator Addressing mode. 
This instruction as well as the other shift and rotate instructions may be used in 
that mode or the Zero Page, Zero Page Indexed, the Absolute, or the Absolute 
indexed mode as indicated in the tables in Chapter 5. 

The ASL instruction, as well as other shift and rotate instructions affect 
the Negative, Zero, and Carry flags in the Processor Status Register when they 
are executed. 

LOGICAL SHIFT RIGHT 

The LSR (Logical Shift Right) instruction, despite the word “Logical” 
rather than “Arithmetic,” does the same thing as the ASL, except in the oppo¬ 
site direction. Each time it is executed, a zero is moved into the leftmost bit, the 
rest of the bits are shifted to the right, and the rightmost bit goes over into the 
Carry flag. 


Accumulator 

7 6 5 4 3 2 1 0 Carry bit 

Figure 10-5. Operation of LSR 

We will demonstrate this instruction by loading a value to be shifted into the 
accumulator from a memory location, and shift it right a given number of times. 
After each shift, the value of the accumulator is stored in another memory loca¬ 
tion. Every shift after the first stores the value in the next highest memory loca¬ 
tion. 


Address 

Data 

1100 

Original value 

1101 

Number of shifts 

1102 

Result of 1 shift 

1103 

Result of 2 shifts 

1104 

Result of 3 shifts 

1105 

etc. 


Figure 10-6. Memory Use for Shift Right 
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The program is detailed below. 


Instruction 

Remarks 

*=$1000 

Start the program at location 1000 

CLC 

Clear the Carry bit 

LDX #0 

Set the memory pointer to zero 

LDA $1100 

Get the value to be shifted 

LDY $1101 

Load the number of times that the number is 
to be shifted into Y 

LOOP LSR A 

Shift it once 

STA $1102,X 

Put it in the next memory location 

INX 

Point to the next location 

DEY 

Find out if we have shifted enough 

BNE LOOP 

If not, go back and shift 


This program will take the number that you put in location 1100 (hex) and shift 
it right just as many times as you have told it to in location 1101. The results of 
each shift will be stored starting in location 1102 and continuing for as many 
locations as there are shifts. Enter the program below and assemble it. 


RIGHT SHIFTER PROGRAM 
010 *=$1000 
020 CLC 

030 LDX #0 

040 LDA $1100 

050 LDY $1101 

060 LOOP LSR A 
070 STA $ 1102,X 

080 INX 

090 DEY 

100 BNE 

110 END 


LOOP 
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Now enter DEBUG and put any value you want to see shifted into locationl 100. 
Suppose the value is 80 (hex). You would enter: 

BUG - - - -- 

DEBUG You typed these j 

ci i oo<8o 

Now enter the number of times that you want the number to be shifted into lo¬ 
cation 1101. Suppose it is 7. You type: 

C110K07 


You now have: 


Address 


Data 


1100 80 

1101 07 


Now you are ready to run the program. Type: G1000, and press the RETURN 
key. To see the results, type D1102,1108. This will let you look at the seven lo¬ 
cations used torstore the shifted values. 

GIOOO^, 

1011 A=01 X=07 Y=00 P=32 S=00 

DEBUG 

Dll02,1108 --— 

1102 40 20 10 08 04 02 
1108 01 
DEBUG 



And there they are! Note the values in the registers when the program was fin¬ 
ished: 


• The accumulator contains the last shifted result. 

• The X register contains the number of times that the accumulator was 
shifted. 

• The Y register is zero, indicating that all 7 shifts have been performed. 

• The P register shows that the Carry flag is not set. That is because there 
were not enough shifts made for the one to be bumped over into the 
Carry bit. 

If you could see the data in memory locations 1102 through 1108 in bi¬ 
nary form, the shifts would be more apparent. 
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Address 

Binary Data 

1102 

01000000 

1103 

00100000 

1104 

00010000 

1105 

00001000 

1106 

00000100 

1107 

00000010 

1108 

00000001 


Now try shifting 8 times and see what happens. Change memory location 
1101 and execute the program again. Display memory locations 1102 through 
1109 this time. 

"Cl 101<8 
G1000 

1011 A=00 X=08 Y=00 P=33 S=00 

D1102,1109 

1102 40 20 10 08 04 02 
1108 01 00 
DEBUG 


Notice the P register contains 33 at the end of the run. The Carry bit was 
turned on by the last shift right. 

Show what values would be in the four registers if you executed the pro¬ 
gram with the following values in memory. 


Address 


Data 


1100 80 

1101 0A 


Try entering the values in Figure 10-7 at locations 1100 and 1101. Fill in 
the values in memory at the end of the program’s execution, 
the values in memory at the end of the program’s execution. 
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Address 

Data 

1100 

91 

1101 

03 

1102 


1103 


1104 



Address 

Data 

1100 

33 

1101 

04 

1102 


1103 


1104 


1105 



Address 

Data 

1100 

E7 

1101 

06 

1102 


1103 


1104 


1105 


1106 


1107 



Figure 10-7. LSR Exercises 


The two rotate instructions basically do the same thing as the shift instruc¬ 
tions, with one important difference. Instead of throwing out the Carry bit and 
filling in a zero at one end of the byte, the Carry bit is rotated back into the 
original byte again. 

ROTATE LEFT 

The rotate left instruction (ROL) tells the computer to think of data in 
terms of blocks in a wheel instead of blocks in a straight line. 



Figure 10-8. Rotate Left Wheel 
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Or as is more conventional: 



Carry 


When a large number of rotations are made in succession, no bits are lost. 
They merely go round and round to different positions. It’s something like the 
game of musical chairs except that no one takes any of the chairs away. There’s 
always a place for each bit of data to go. 

The next program sets the Carry bit and loads the accumulator with 1. 
Then the accumulator is rotated left eight times. On the last rotate, the Carry 
bit is set by the 1 that has been rotated through the accumulator. The accumula¬ 
tor ends up with a value of 80 due to the original carry that has rotated through 
the accumulator. 

Enter the program and assemble it. 

010 *=$1000 

020 SEC 

030 LDA #1 

040 ROL A 

050 ROL A 

060 ROL A 

070 ROL A 

080 ROL A 

090 ROL A 

100 ROL A 

110 ROL A 

Now run the program by entering the Debugger mode and typing: G1000. 
(Don’t forget the RETURN key.) You should see: 


G1000 

100B A=80 X=00 Y=00 P=B1 S=00 

DEBUG 


^.-Negative flag 

0 0 0 o| I 1 0 1 1 0 0 0 I^P ^^Carry flag 


P Register 
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You can see from the P register that the Carry and Negative flags are set. 
The carry was set when the 1 that we had in the accumulator was shifted all the 
way over and out of the accumulator and into the Carry bit. The Negative flag 
was set when the value of the accumulator became CO (and stayed set for 80) 
due to the shifting. 

Examine the trace of the program that follows. 


DEBUG 

T1000 

1000 38 SEC 

A=00 X=00 Y=00 P-31 S=00 

1001 A9 01 LDA #$01 

A=01 X=00 Y=00 P=31 S=00 

1003 2A ROL A 

A=03 X=00 Y=00 P=30 S=00 

1004 2A ROL A 

A=06 X=00 Y=00 P=30 S=00 

1005 2A ROL A 

A=0C X=00 Y=00 P=30 S=00 

1006 2A ROL A 

A=18 X=00 Y=00 P=30 S=00 

1007 2A ROL A 

A=30 X=00 Y=00 P=30 S=00 

1008 2A ROL A 

A=60 X=00 Y=00 P=30 S=00 

1009 2A ROL A 

A=C0 X=00 Y=00 P=B0 S=00 

100A 2A ROL A 

A=80 X=00 Y=00 P=B1 S=00 

100B 00 BRK 

A=80 X=00 Y=00 P=B1 S=00 

DEBUG 

■ 

In the first step, the Carry flag is set by the SEC instruction. Then a 1 is 
loaded into the accumulator. After the first ROL instruction, bit 7 of the accu¬ 
mulator (a zero) has been moved into the Carry bit, resetting it (as shown by 
P=30). The old value of the Carry bit (a one) is moved into bit 0 of the accumu¬ 
lator. All the rest of the bits in the accumulator have been shifted one position 
to the left, giving a value of 03 in the accumulator. 

Figure 10-9 shows the binary results of each step in the program. 

After the seventh rotate instruction has been executed, the accumulator 
has a value of CO. This sets the Negative flag, making P=B0. After the next ro- 
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Step 

Instruction 

Carry 

Accumulator 

1000 

SEC 

1 

00000000 

1001 

1003 

LDA #01 

ROL A 

c> 

.00000001 

/ 

oooooori 

1004 

ROL A 

0 

00000110 

1005 

ROL A 

0 

00001100 

1006 

ROL A 

0 

00011000 

1007 

ROL A 

0 

00110000 

1008 

ROL A 

0 

01100000 

1009 

ROL A 


.11000000 





100A 

ROL A 


10000000 


This is the 
way it rotates 


Figure 10-9. Accumulator and Carry Rotates 

tate, bit 7 of the accumulator (a one) gets moved into the Carry bit, setting it 
and making P=B1. The value, 80, is left in the accumulator. 


ROTATE RIGHT 


The rotate-right instruction (ROL) works in the opposite direction as ro¬ 
tate left. As successive rotate-right instructions are executed, the bits in the accu¬ 
mulator and carry go around and around clockwise. 



Figure 10-10. Rotate-Right Wheel 
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A rotate-right instruction executed following a rotate-left instruction 
would put all bits back in their original place. 


Example: 


1. Originally 

2. ROL A causes 


3. ROR A causes 
Back to original 


0 || 10101010 | 

///////^ 


1||01010100 
I 0 | | 1 0 1 0 1 0 1 0 | 



I don’t know why anyone would want to do that, but you might think up 
a reason. 

To demonstrate the ROR instruction, look back to the Right Shifter Pro¬ 
gram and see how it might be changed to make it a Right Rotater Program. Only 
this time provide the following initial values: 


• Carry bit = 1 

• Memory location 1100 = 0 

• Memory location 1101 =0 

• Rotate right memory location 1100 8 times 

• Store the result of each rotation in successive memory locations from 
1111 through 1118 


You might do it like this: 


0100 

*=$1000 


0110 

SEC 



0120 

LDY 

$1101 

Remember that shift and 

0130 

LOOP ROR $1100 

rotate can be used in the 

0140 

LDA 

$1100 ) 

Absolute Addressing mode 

0150 

STA 

$1111,Y 

s. 

0160 

INY 


^ Transfer result to locations 

0170 

CPY 

#8 

1111 through 1118 

0180 

BNE 

LOOP 


0190 

END 




We changed the program quite a bit to show you that there’s more than 
one way to achieve the same result. The Y register now serves as a loop counter 
and as an index to store the result of each rotate. 
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Enter the program and assemble it. Then go to the DEBUGGER to store 
the initial values in memory. 



Single step the program and watch the accumulator change as it is loaded 
from 1100 each time the instruction at 1007 is executed. Also watch the Y regis¬ 
ter change at 100D. 
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Continue single stepping until the program ends. When finished, display 
memory locations 1111 through 1118. 



1111 80 40 20 10 08 04 02 
1118 01 


DEBUG 


You are now able to manipulate data in four ways. Proceed to the sum¬ 
mary and then the exercises. 
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SUMMARY 

This chapter contains discussions of shift and rotate instructions to pre¬ 
pare you for multiplication and division operations which follow in the next 
chapter. You learned that: 

• Multiplication and division operations are performed by a series of addi¬ 
tions, subtractions, and place location shifts; 

• Shifting a binary digit left one place doubles the place value of the digit; 

• Shifting all bits of a binary number left one place doubles the value of 
the binary number; 

• Shift and rotate instructions may be used in the following address 
modes; 

Accumulator, Zero Page, Zero Page Indexed, Absolute, and Absolute 
Indexed (however, only the X register can be used for indexing); 

• The following diagrams show the operation of the shift and rotate 
instructions: 



C D 7 D 6 D 5 D 4 D 3 D 2 D 1 D° H ROR 




EXERCISES 

1. What would be the decimal equivalent of the result of shifting the following 
binary number two times left? 

0 0 0 1 0 1 1 0 (binary number before shifts) 

_ decimal equivalent after two shifts 
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Exercise 2 through 6 assume the following binary digits are in the accumu¬ 
lator and Processor Status Register. Show the contents of each after the speci¬ 
fied instructions have been executed. 


Accumulator 
P register 


2. After: ASL A 

ASL A 
ASL A 

3. After: LSR A 

LSR A 


4. After: ROL A 

ROL A 
ROL A 

5. After: ROR A 

ROR A 


6. After: ROR A 
LSR A 
ROL A 
ASL A 


[~0 1 0 1 0 0 1 T] 1 at the beginning 

> of each exercise 

|0 0 1 1 0 0 0 ol ) 

N V B D I Z C 

Accumulator 
P register 
Accumulator 
P register 
Accumulator 
P register 
Accumulator 
P register 
Accumulator 
P register 


0 110 0 


o 1 1 I olo 


0 I 1 I 1 I 01 0 


°hh 1 ° ° 


0 110 0 


7. Assume you are using the Right Shifter Program, and you use the following 
command sequence: 

DEBUG 
Cl 100< FF,08 
G1000 

(a) Show the bits contained in the accumulator at the end. 


(b) the Carry bit is 


(set, reset) 
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8. In exercise 7, show the contents of these memory locations in hexadecimal 
notation. 



From Figure 10-7 


ANSWERS 



4. Accumulator 
P register 


N=1, Z=0, C=0 
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5. Accumulator 

| 1 0 0 1 

I 0 

1 

0 

3 


P register 

| 1 0 1 1 

1 o" 

~0~ 

T 

T| 

N=1, Z=0, C=1 

6. Accumulator 

1 o 1 0 • 

1 0 

~0~ 

T 

Z1 


P register 

| 0 0 1 

1 0 

~0~ 

~0~ 

n 

N=0, Z=0, C=0 


7. (a) looooooool 

(b) set 


1102 

7F 

1103 

3F 

1104 

IF 

1105 

OF 

1106 

07 

1107 

03 

1108 

01 

1109 

00 




Chapter 11 


Multiplication, Division, 
and Subroutines 


Since the 6502 instruction set does not contain instructions for multiplica¬ 
tion and division, it is up to you to develop methods to perform these operations. 
Multiplication can be thought of as a series of additions. 

Example: 

3 X 12=12+12 + 12 
and 

5 x 16 = 16 + 16 + 16 + 16 + 16 

You can very easily write a program using a loop to add one number a 
specified number of times to obtain the same answer that would result from 
multiplying the two numbers. 

MULTIPLICATION BY ADDITION 

CLC 
LDX #5 
LDA #0 

LOOP ADC $1100 
DEX 

BNE LOOP 
END 

If a second number (10 for example) is loaded into memory location 1100, 
and the program is assembled and executed, the accumulator would contain the 
desired result at the end of the program. 

Although it is very quick and easy to write a program for this method, you 
can see that it would be time consuming to execute the multiplication of large 
numbers. That would require many passes through the loop. It would work for 
8-bit numbers but would have to be redesigned for larger numbers requiring 
more than 8 bits. Due to the inefficiency of the program, it is seldom used. 

Division could be performed in a similar manner, subtracting the divisor 
each time through a loop. However, that method has the same drawbacks of 
the multiplication method. 


Load X with one number 

Add second number each 
time through the loop 
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Since you’ve learned all about shifts and rotates in Chapter 10, let’s see if 
you can make use of them to solve multiplication and division problems. 


EIGHT-BIT MULTIPLICATION 


Let’s start with 8-bit numbers and look at the multiplication process first. 
Remember, the computer does its arithmetic using binary numbers. First look at 
a pencil-and-paper example of binary multiplication. Multiply 18 (decimal) by 
58 (decimal) using both decimal and binary multiplication. 


Decimal 


Binary 


18 -Multiplicand-► 0001 0010 

x58 -- Multiplier- -x 0011 1010 

144 0000 0000 

90 0 0010 010 


1044 



Product 


00 0000 00 
000 1001 0 
0001 0010 
0 0010 010 
00 0000 00 

000 0000 0 _ 

000 0100 0001 0100 


IT CHECKS ! 


4 (decimal) 
16 (decimal) 
+1024 (decimal) 
1044 (decimal) 


Notice that your multiplication involves adding the multiplicand every 
time that a one appears in the multiplier. Of course, there is a shift to the left 
each time a bit of the multiplier Is used just as there is in decimal multiplication. 
You also proceed from right to left as you “use up” the bits of the multiplier. 

The program that we will use does much the same thing. The first part of 
the program will initialize the memories with the appropriate values. We will 
store these quantities in memory as follows: 


Memory 

Address 

Contents 

1100 

Most Significant Byte of product 

1101 

Least Significant Byte of product 

1102 

Multiplicand (12) 

1103 

Multiplier (3A) 


Figure 11-1. Memory Use for Multiplication 
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The accumulator will temporarily hold the Least Significant Byte of the 
product as the program is executed. You may notice that the multiplier is used 
from left to right (the opposite of the usual paper-and-pencil method) to simp¬ 
lify the process. 



The flowchart in Figure 11-2 clarifies the action in the program. 
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The housekeeping chores at the beginning of the program are easy for you 
now. You have used each instruction in this section of the program before. They 
are all either load or store instructions in various addressing modes. 

This section of the assembly language program would look like this: 


EDIT 

NUM 100,10 

100 *=$1000 

110 LDX #8 

120 LDA #$12 

130 STA $1102 

140 LDA #$3A 

150 STA $1103 

160 LDA #0 

170 STA $1100 

180 STA $1101 


The loop section performs the multiplication. Two instructions appear 
that you learned about in the last chapter. One of them is ASL (Arithmetic 
Shift Left). It is used to shift the contents of the accumulator at statement num¬ 
ber 190. It is also used in the Absolute Addressing mode at statement number 
210. When used in this mode, the bits of the specified memory location (1103) 
are shifted left. 



Example: 

Memory 1103 before ASL $1103 
To carry —| o|o|o|l|o|o|l |o | 

Processor , /////// , 

Status 0 010 01 0 0 p—0 appears by magic 

Register -------- 1 

Memory 1103 after ASL $1103 

We will make use of the fact that the Most Significant Bit from the shift is 
moved to the carry bit of the Processor Status Register. 

At statement 200, you will make use of the ROL (Rotate Left) instruction 
in the Absolute Addressing mode. In Chapter 10, you used this instruction with 
the accumulator. This time it is used to rotate the bits in memory address 1100. 
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Memory 1100 before ROL $1100 

I 0 I 0 I 0 I 0 I 0 I 0 I 1 I 0 I 


To Carry 
bit of 
Processor 
Status 
Register ^ 


Memory 1100 after ROL $1100 


X is either 0 or 1 
depending on the 
Carry bit when the 
instruction is 
executed 


As each instruction is executed, the Most Significant Bit moves into the Carry 
bit of the Processor Status Register. In the ASL instruction, the Least Significant 
Bit is filled with a zero. In the ROL instruction, the Least Significant Bit is filled 
from the Carry bit of the status register (either a 1 or a 0). The instructions de¬ 
rive their names from the action that they cause. 


*t—fel l 7 6 5 4 3 2 1 0| -0 [c ]| 7 6 5 4 3 2 1 oK 


Here is the section that performs the loop, which is the heart of the pro¬ 
gram. 

190 LOOP ASL A 

200 ROL $1100 

210 ASL $1103 

220 BCC SKIP 

230 CLC 

240 ADC $1102 

250 BCC SKIP 

260 INC $1100 

270 SKIP DEX 
280 BNE LOOP 


After the loop has been executed 8 times (once for each bit in the multi¬ 
plier, the Least Significant Byte of the result will be in the accumulator. This is 
stored in the final section of the program in memory location 1101 for later dis¬ 
play. The program then ends. 

The Most Significant Byte of the result is now in memory location 1100, 
and the Least Significant Byte of the result is in memory location 1101. 
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The Last Section 
290 STA $1101 
300 END 


USING THE 8-BIT MULTIPLICATION PROGRAM 


Enter the program in the Writer/Editor mode. Then assemble it. We used 
the Atari 820 Printer as we assembled the Multiplication Program so that we 
could see the complete program at one time. It is a long program, and it may not 
all show on the video screen. Here is what our printed assembled program looks 
like. 


0000 


0100 

*= 

$1000 

1000 

A208 

0110 

LDX 

#8 

1002 

A912 

0120 

LDA 

#$12 

1004 

8D0211 

0130 

STA 

$1102 

1007 

A93A 

0140 

LDA 

#$3A 

1009 

8D0311 

0150 

STA 

$1103 

100C 

A900 

0160 

LDA 

#0 

100E 

8D0011 

0170 

STA 

$1100 

1011 

8D0111 

0180 

STA 

$1101 

1014 

0A 

0190 LOOP 

ASL 

A 

1015 

2E0011 

0200 

ROL 

$1100 

1018 

0E0311 

0210 

ASL 

$1103 

101B 

9009 

0220 

BCC 

SKIP 

101D 

18 

0230 

CLC 


101E 

6D0211 

0240 

ADC 

$1102 

1021 

9003 

0250 

BCC 

SKIP 

1023 

EE0011 

0260 

INC 

$1100 

1026 

CA 

0270 SKIP 

DEX 


1027 

D0EB 

0280 

BNE 

LOOP 

1029 

8D0111 

0290 

0300 END 

STA 

$1101 


Figure 11-3. Printout of Assembled Multiplication Program 


You’re ready to execute the program. You don’t have to load any data 
this time as the program is going to do it for you. Enter the DEBUGGER and 
execute the program. 
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'edit 

BUG 

DEBUG 

G1000 

102C A=14 X=00 Y=00 P=32 S=00 

DEBUG 


The result of the multiplication can be found in memory locations 1100 
(Most Significant Byte) and 1101 (Least Significant Byte). You can display them 
both at once by typing: 

Dll 00,1101 



It checks with our previously hand-calculated result. 


While you are in the Debugger mode, make changes to the multiplier and 
multiplicand. They are in memory locations 1003 and 1008. Try using the fol¬ 
lowing pairs of hexadecimal numbers and put your results in the appropriate 
places in Figure 11-4. 


Multiplier 

(1003) 

Multiplicand 

(1008) 

Result 

(1100 and 1010) 

03 

09 


1A 

E4 


3C 

D8 


A4 

C2 


FF 

_fF_ 



Figure 11-4. Multiplication Exercises 
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Remember, there is a Change Memory command in the Debugger mode. 
Here are two ways to get ready for the first modification. 


DEBUG 
Cl 003<03 

DEBUG 
Cl 008<09 



In two steps 


or 

""debug 

C1003<03 ,,,,, 09 -*- In one step 

DEBUG 


Most people working with machine language programming agree that an 
assembler removes much of the drudgery. If the previous multiplication program 
had been programmed in machine language directly, there would have been 
many details to take care of. 

• Individual addresses would have had to be assigned to each instruction 
and its operand. 

• Branch locations would have had to be calculated. 

• Individual Op Codes would have had to be looked up in an instruction 
table. 

• Conversion between decimal and hexadecimal notation would have 
been necessary. 

The Atari Assembler programs make life much easier. The Writer/Editor 
Program cannot execute a program directly, but it takes care of assigning Op 
Codes and the operands that go into the machine language Object Program. 

The Assembler relies on the Debugger Program for execution of the assem¬ 
bled program and for examination of memory for results. The combination of 
Editor, Assembler, and Debugger are hard to beat. The Assembler does all the 
detail work, and the Debugger provides the execution and debugging capabilities. 
Of course, the Editor allows you to communicate your wishes to the Assembler. 

After that brief introduction to multiplication, let’s move on and take a 
look at the division process. 
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EIGHT-BIT DIVISION 

Once again, we’ll take a look at pencil-and-paper division before looking at 
the computer’s method. Since division is the inverse operation of multiplication, 
we’ll use the same numbers that we used in the multiplication example with one 
exception. That exception is made to the dividend so that the division example 
will not come out even. There will be a remainder. 

Example: 

1046 (decimal) -s- 58 (decimal) 

Decimal Binary 

18 quotient _ 1 0010 quotient 

58 )l046 0011 1010 ) 0100 0001 0110 

58 0011 1010 

111 011 
m 010 

2 remainder 10 remainder 

( 1 0010= 12 HEX = 18 dec. 

It checks-- ) 10= 2HEX= 2 dec. 

Just as in multiplication, you can see shifts being made as the division takes 
place. Place value is very important in this process. Notice that a subtraction is 
made only if the divisor is smaller than part of the dividend that is being tested. 
A one then is placed in the quotient. If the divisor is larger, a zero is placed in 
the quotient. 

Our assembly language program for division will look much the same as 
the multiplication program. The first part of the program places the appropriate 
values in their respective memory locations. Figure 11-5 shows the placement of 
the data. 


466 

464 


Memory 

Address 

Contents 

A t the Start 

A t the End 

Accumulator 

Most Significant 

Byte of dividend 

Remainder 

1100 

Divisor 

Quotient 

1101 

Least Significant 

Byte of dividend 

- 

1102 

- 

Remainder 


Figure 11-5. Memory Use for Division 
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The flowchart for the program is given in Figure 11-6. The accumulator 
and memory location 1101 begin with the original dividend. Each time through 
the loop, the contents of memory location 1101 are shifted left, and the accu¬ 
mulator is rotated left. If a carry occurs from the shift of memory location 1101, 
it will appear as a 1 in the Least Significant Bit of the accumulator when it is ro¬ 
tated. If no carry occurs from the memory 1101 shift, a zero appears in the 
Least Significant Bit of the accumulator. Thus each time through the loop, the 
dividend is shifted one place from memory 1101 to the accumulator. This lets 
the computer compare the divisor with the most significant part of the dividend 
for a trial division. 



EXIT 


Figure 17-6. Division Flowchart 
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The division is accomplished by comparing the divisor with the accumula¬ 
tor. Every time that the divisor is smaller than, or equal to, the accumulator, the 
divisor is subtracted from the accumulator and memory 1101 is incremented by 
one. This means a 1 is appearing in the quotient. 

If the divisor is larger than the accumulator, no subtraction is made and 
memory 1101 is not incremented. This means a zero appears in the quotient. 

As the bits in the accumulator and memory 1101 move to the left, the 
quotient appears in memory 1101 from the right (0 if divisor did not go into 
dividend, 1 if divisor did go into dividend). 

After the loop is completed (8 passes through), the remainder is placed in 
memory location 1102. When the program is complete, you’ll find the 8-bit quo¬ 
tient in memory location 1101 and the remainder in memory location 1102. 

The housekeeping chores are similar to those of the Multiplication Pro¬ 
gram. 


10 *=$1000 


20 

LDX 

#8 

30 

LDA 

#$3A 

40 

STA 

$1100 

50 

LDA 

#$16 

60 

STA 

$1101 

70 

LDA 

#4 


The main part of the program comes next. The rotate instruction appears 
in a different form in the loop in this program. We are using ROL A to rotate 
the accumulator. It works the same way as it did when we rotated a memory lo¬ 
cation. Only this time, the accumulator’s contents are rotated. The loop is again 
executed 8 times using the X register as a counter. 

80 LOOP ASL $1101 
90 ROL A 

100 CMP $1100 

110 BCC BRANCH 

120 SBC $1100 

130 INC $1101 

140 BRANCH DEX 
150 BNE LOOP 

When the loop has been completed 8 times, the contents of the accumula¬ 
tor (the remainder) is stored in memory location 1102 for ease of display. 


160 STA $1102 
170 END 
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Enter and assemble the program now. The assembled program should 
look like this: 


0000 


10 

*= 

$1000 

1000 

A208 

20 

LDX 

#8 

1002 

A93A 

30 

LDA 

#$3A 

1004 

8D0011 

40 

STA 

$1100 

1007 

A916 

50 

LDA 

#$16 

1009 

8D0111 

60 

STA 

$1101 

100C 

A904 

70 

LDA 

#4 

100E 

0E0111 

80 LOOP 

ASL 

$1101 

1011 

2A 

90 

ROL 

A 

1012 

CD0011 

0100 

CMP 

$1100 

1015 

9006 

0110 

BCC 

BRAN< 

1017 

ED0011 

0120 

SBC 

$1100 

101A 

EE0111 

0130 

INC 

$1101 

101D 

CA 

0140 BRANCH DEX 


101E 

D0EE 

0150 

BNE 

LOOP 

1020 

8D0211 

0160 

STA 

$1102 


0170 END 


Figure 11- 7. Printout of A ssembled Division Program 


Enter the Debugger mode, execute the program, and display the results. 

[^EDIT 

BUG 


DEBUG 

G1000 

1023 A=22 X=00 Y=00 P=32 S=00 

DEBUG 

D1101,1102 

y - Quotient 

1101 12 02 

^- Remainder 

DEBUG 


This checks with the hand calculated result. 

Try the additional division problems given in Figure 11-8. The answers 
appear at the end of the chapter exercises. 
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Dividend 

Divisor 

Result 

MSB 

(100D) 

LSB 

(1008) 

(1003) 

Quotient 

(1101) 

Remainder 

(1102) 

01 

00 

10 



0A 

BC 

DE 



0A 

05 

9F 



05 

AA 

83 



7F 

FF 

FF 




Figure 11-8. Division Exercises 


If you try any other examples, make sure that the quotients do not exceed 
FF. The program will not work for quotients larger than one byte. 

SUBROUTINES 

Quite often, a set of instructions must be executed at several different 
places within a program. Rather than write the instructions at each place they 
are used in the program, it is more efficient to write the instructions once, as a 
subroutine to your program. Each time that you wish to execute the set of in¬ 
structions, you insert the Jump to SubRoutine instruction. 

Example: 

Suppose that you have a subroutine labeled SUBEEP. The JSR 

instruction would be: 

JSRSUBEEP 

Once you have executed the subroutine, you must have a way to get back 
to the main program. And you must come back to the instruction that follows 
the JSR instruction that sent you to the subroutine. This is done by placing a 
RTS (ReTurn from Subroutine) instruction as the last instruction executed in 
the subroutine. 

Subroutine 

Instructions 


RTS 
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The subroutine could be "called” from the main program by the JSR 
SUBEEP instruction. The subroutine would be executed, and control would be 
returned to the main program as follows: 


Main Program 



Figure 11-9. Subroutine Flow 

Remember the stack that was discussed in Chapters 1 and 5? When a JSR 
instruction is executed, the computer automatically places the memory address 
contained in the program counter on the stack. Then, when the RTS instruction 
is executed at the end of the subroutine, the computer takes the address from 
the stack and places it back in the program counter. The execution of the main 
program then continues from that point. 


Jumping to the Subroutine 
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Program 

Counter 


1020 JSR SUBEEP . When the JSR instruction is 

1021 next instruction * executed, the program 

counter is “pointing” to the 
next instruction. 



Stack The address 1021 is placed 

on top of the stack. 


The address of the subroutine is placed in the program counter. 


noo |)2i | 


Program Counter 


The program counter then forces the computer to execute the instructions 
beginning at location 1100 (the subroutine). 

Returning from the Subroutine 


The subroutine 
is executed 



Program Counter And placed back in 
/the Program Counter. 

V 




This forces the computer to execute the next instruction starting at loca¬ 
tion 1021. 
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You should remember that the stack is made up of 8-bit memory loca¬ 
tions. Addresses may be 16 bits long. Therefore, the process is a little more com¬ 
plicated than the previous description indicates. The address is actually placed 


on the stack as two separate bytes. 


- low-order byte on top 

- high-order byte first 

- other values may be here 


When the RTS instruction is executed, the return address is also picked off 
the stack in two separate bytes. In other words, the RTS instruction reverses the 
process performed by the JSR instruction. They work together just like the GO- 
SUB and RETURN instructions of BASIC. 

Subroutines in assembly language may be nested, just as subroutines in 
BASIC. 


USING A SUBROUTINE 

Let’s return to the 8-bit multiplication program used earlier in this chapter 
and add a sound subroutine that will play a different sound each time one of the 
bits of the multiplier is used. You will need to insert many new instructions in 
the original program. Several new instructions will be introduced which use the 
stack to save and retrieve information. 

THE MAIN PROGRAM (Unchanged Portion) 

100 *=$100 

110 LDX #8 \ 

120 LDA #$12 1 

130 STA $1102 f Data Initialization 

140 LDA #$3A 

150 STA $1103 

160 LDA #0 

170 STA $1100 

180 STA $1101 

190 LOOP ASL A 

200 ROL $1100 

210 ASL $1103 

220 BCC SKIP 

230 CLC 

240 ADC $1102 

250 BCC SKIP 

260 INC $1100 



Multiplication Loop 
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MAIN PROGRAM (Changed Portion) 


270 SKIP PHA 
280 PHP 
TXA 
PHA 

JSR SUBEEP - 

PLA -- 

TAX 
PLP 
PLA 
DEX 


290 

300 

310 

320 

330 

340 

350 

360 

370 

380 

390 


BNE LOOP 
STA $1101 
BRK -- 


Here’s where you GOSUB 
You come back here 


Program ends here 


1024 

SUBEEP 

1051 

1059 

Nested 

Subroutine 

1061 


, 400 
' 410 
420 
430 

1 440 
450 
460 
470 
480 
f 490 
500 
510 
520 
530 
1 540 

1 550 
560 
570 
580 
590 
600 
610 


Subroutine SUBEEP 

SUBEEP LDA #$C8 
STA $CE 
LDA #A0 
STA $D201 
LDA $1103,X 
STA $D200 
LDA #$AF 
ALOOP STA $D201 
LDA $CE 
JSR DELAY 
SEC 

SBC #$01 
CMP #$9F 
BNE ALOOP 
RTS 

DELAY LDY #$13 -* 
DELAY2 DEY 
BNE DELAY2 
DEX 

BNE DELAY 
RTS 
END 


Jump to nested sub 
Return here 


End of SUBEEP 
Start of nested sub 


End of Nested sub 


The program is executed in the order shown in Figure 11-10. The sub¬ 
routine SUBEEP is called eight times from the main program. The subroutine 
labeled DELAY is nested within subroutine SUBEEP. 



230 M UL TIPLICA TION, Dl VISION, A ND SUBROUTINES 



Figure 11-10. Sound Subroutine Flow 


The frequency of the sound is controlled by the value stored in D200 
from the data table at 1103+X. The audio control register at D201 controls the 
volume of the sound. 

Since the 6502 microprocessor has only two index registers (X and Y), a 
new programming technique is demonstrated at 270-300 and 320-350. The 
main program and the subroutines use the X register and accumulator for differ¬ 
ent purposes. Therefore, before the subroutines are called, all the values in regis¬ 
ters X, A, and P are saved on the stack so that the registers may be used by the 
subroutines in their own way. 

PHA PusH the Accumulator on the stack 
PHP PusH the P register on the stack 

TXA and PHA Transfer X to Z, then PusH A on the stack 

When JSR is executed, the information goes on the stack in this way. 


Top 


Bottom 

Stack 



When SUBEEP’s RTS instruction is executed, the return address is pulled 
off the stack leaving the following data. 
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231 


Low "*- 

High -- 

To Program 

Counter / X-reg. / -*-Now on top 

/ A reg. / 

Stack 

The computer then returns to the main program and executes in order: 

PLA ) ^_— Pull off top of stack and 

TAX / transfer to X register 

PLP -*-Pull off stack and place in P register 

PLA -*-Pull off stack and place in A register 

Notice that values are pulled off the stack in the reverse order of the way 
they were pushed on. This restores everything to the proper place. 

Enter the program as given and assemble it. Then go to DEBUG and enter 
the data in the data table at 1104 through 110B. 


Address 

Data 

1104 

48 

1105 

60 

1106 

78 

1107 

90 

1108 

A8 

1109 

CO 

110A 

D8 

hob 

F0 


Figure 11-11. Data for Sound Program 


Execute the program and see how you like the notes that are produced by 
the sound subroutine SUBEEP. If you want to change the notes, change the data 
shown in Figure 11-11. The frequencies are picked off in reverse order from 
11 OB through 1104. 
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SUMMARY 

You have now seen how two operations for which the computer has no in¬ 
structions can be performed by putting together groups of other instructions. 
Although the 6502 microprocessor has no multiplication or division instructions, 
the operations can be performed as a series of additions, subtractions, and shifts 
or rotations. You have learned in this chapter to: 

• Apply the shift and rotate instructions in programs to multiply and di¬ 
vide numbers; 

• Use a demonstration program that multiplies two 8-bit numbers to pro¬ 
duce a 16-bit result; 

• Use a demonstration program that divides an 8-bit divisor into a 16-bit 
dividend producing an 8-bit quotient and an 8-bit remainder; 

• Use a subroutine called by a JSR (Jump to SubRoutine) instruction and 
return to the main program with a RTS (ReTurn from Subroutine) 
instruction; 

• Use the stack to save and retrieve information when registers or coun¬ 
ters must be used in more than one way; 

• Use the following other new instructions; 

PHA Push the value in the accumulator onto the stack 

PHP Push the P register’s contents onto the stack 

PLA Pull the top value off the stack and put it into the accumulator 

PLP Pull the top value off the stack and put it into the P register 

• Use a subroutine producing musical tones 


EXERCISES 

1. Multiply the decimal numbers 28 and 37. 

(a) Using decimal notation (b) Using binary notation 


28= 

x37= 



(c) Check the binary result 
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2 . 


According to the flowchart in Figure 11-2, which bit of the multiplier is 

used first? _ 

(most significant, least significant) 


Exercises 3-7 refer to the following sketches of the Carry bit and the accu¬ 
mulator before and after one of the shift or rotate instructions are given. 


(a) Carry Accumulator 

m 101010111 | before 
1~0~1 |l010m0| after 

(b) Carry Accumulator 

n~| 101010111 1 before 

[~0~| | 10101111 | after 


(c) Carry Accumulator 

m lOIOIOm 1 before 

|T1 100101011 | after 

(d) Carry Accumulator 

m 101010111 | before 

|T~| 110101011 | after 


3. Name the shift or rotate instruction performed in a_ 

4. Name the shift or rotate instruction performed in b_ 

5. Name the shift or rotate instruction performed in c_ 

6. Name the shift or rotate instruction performed in d_ 

7. Fill in the blanks which would result from successive operations for your 
answers from Exercises 3, 4, 5, and 6. 

Originally: Carry Accumulator 

|~T~| | oioiom | 

The instructions for your answers to: 

3, then 4, then 5, then 6 are executed. 

Final conditions: 

Carry Accumulator 

□ rr □ ~r i i n 


8. The 8-bit multiplication program of Figure 11-3 is to be used to multiply 
120 (decimal) by 73 (decimal). 

(a) What hexadecimal values must be loaded into which two memory 
locations? 


Address 

Data 








234 MULTIPLICATION, DIVISION, AND SUBROUTINES 


(b) Show how to use the DEBUGGER to load the values by one command. 


DEBUG 


9. The assembly language instruction used to call a subroutine labeled SUBBY 
would be: 


10. The last instruction executed by a subroutine must be: 


ANSWERS 


Answers to Figure 11-4 


Multiplier 

Multiplicand 

Result 

03 

09 

00 IB 

1A 

E4 

17 28 

3C 

D8 

32 A0 

A4 

C2 

7C 48 

FF 

FF 

FE 01 


Answers to Figure 11-8 


Dividend 

Divisor 

Result 

Quotient 

Remainder 

01 00 

10 

10 

00 

0A BC 

DE 

OC 

54 

0A 05 

9F 

10 

15 

05 AA 

83 

0B 

09 

7F FF 

FF 

80 

7F 


1. (a) Using decimal notation 

28 

x37 

196 

84 

1036 
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(b) Using binary notation 



2. Most Significant Bit 

3. ASL A 

4. ROL A 

5. LSR A 

6. ROR A 

7. Final conditions: 


Carry Accumulator 



9. JSRSUBBY 
10. RTS 




Chapter 12 


Programming Practice 


Much can be learned about programming by using, analyzing, and modify¬ 
ing programs written by other people. By this time, you are familiar with the use 
of the Atari Assembler Cartridge and should feel at ease using it. Therefore, we 
have devoted this last chapter to programs for you to use and modify to fit your 
own needs. Suggestions are given for some modifications, and you will no doubt 
think of others. 

We have not covered all of the features of the Assembler Cartridge but 
have tried to present those that we think you will use most. 

Programming requires much practice. Therefore, you should try other pro¬ 
grams to investigate all aspects of the 6502 instruction set, as well as Atari 
Assembler Cartridge commands and statements. Seek out those instructions that 
you are not familiar with, study the descriptions, and write some short simple 
programs that make use of them. 

The assembler can be used to develop machine language subroutines that 
can speed up and make your BASIC programs more powerful. Many applications 
using sound effects, high speed graphics, animation, and certain functions not 
available in BASIC can be performed by machine language subroutines. 

As we cautioned earlier, your machine language programs require their 
own area of memory. If you are using assembled subroutines accessed from 
BASIC, you must be careful that your machine language programs are assembled 
in an area of memory that is not used by the BASIC program. There is an area of 
memory from 0600 (1536 decimal) through 06FF (1791 decimal) that can be 
used for this purpose. These 256 bytes that are available will be adequate for 
most of your machine language subroutines. All programs in this chapter use this 
area. There are also 7 bytes of zero page memory that have been reserved for 
your use by the BASIC cartridge (locations CB through D1 or 203 decimal, 
through 209, decimal). In addition, locations D4 and D5 of zero page are used to 
return parameters (numerical values) from machine language subroutines to 
BASIC through the USR function. 

The Assembler User’s Manual, supplied with your Assembler Cartridge, 
contains several entertaining programs. The manual also shows a method to pre¬ 
pare an assembled subroutine and a BASIC program which will access the sub- 


256 
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routine. We will concentrate in this chapter on similar programs that use only 
the Assembler Cartridge. You may rewrite them to be accessed from BASIC if 
you wish. Our first program will demonstrate both methods of using the assem¬ 
bled program. 

BASIC language can perform logic functions by means of the statements 
NOT, AND and OR. There is another logic function in the 6502 instruction set, 
the Exclusive OR. Our first program demonstrates its use. 


USING A LOGIC FUNCTION 

The 6502 microprocessor has instructions that extend the logic functions 
NOT, AND and OR used in BASIC. One of these instructions performs the logic 
function Exclusive OR (Assembly mnemonic EOR). This instruction compares 
two binary numbers, one bit position at a time. If the two bits are alike, a zero 
is placed in the corresponding bit position of the result. If one of the compared 
bits is a 1 (one) and the other is a 0 (zero), a 1 (one) is placed in the correspond¬ 
ing bit position of the result. 


Example: 

10 110 111 first number 


0 0 0 1 1 1 
10 10 10 


unlike 


/MM 

/ unlike unlike 


J_0 

0 1 

\ t 

I unlike 
like 


second number 
result of EOR 


You see that a 1 results in a given bit position if there is a one in the cor¬ 
responding bit position of either one number or the other number, but not if 
there is a one in the corresponding bit position of both numbers. 

The above example shows that the-result of performing an Exclusive OR 
on the hex numbers B7 and 1E is A9. 

Let’s now write an assembly language program to perform the same Exclu¬ 
sive OR as the example. 


EOR SOURCE PROGRAM 


100 *=$0600 start program at 0600 

110 LDA #$B7 

120 EOR #$ 1E 

130 STA $1000 

140 END 


EORB7 and IE 
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Enter and assemble the program. 

ASSEMBLED DISPLAY 


130 ST A $1000 

140 END 

ASM 

0000 100 *= 

0600 A9B7 110 LDA 

0602 491E 120 EOR 

0604 8D0010 130 STA 

140 END 


$0600 
#$B7 
#$1 E 
$1000 


EDIT 


Enter the DEBUGGER and execute the program 
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There it is, very short and quick. Now let’s see how we might access a simi¬ 
lar subroutine from BASIC. The values to be Exclusive ORed will be passed from 
the BASIC subroutine to the subroutine. The subroutine will pull the values off 
the stack, EOR them and pass the result back to BASIC. The flow of the pro¬ 
gram and subroutine is shown in Figure 12-1. 



The BASIC program is very short. Do not enter it in the computer yet. Re¬ 
member the procedure mentioned earlier. 


100 REM ** EOR SUBROUTINE PROGRAM ** 

110 GR.O 

120 A = USR(1536,183,30) 

130 PRINT “183 EXCLUSIVE OR WITH 30 IS”A 
140 END 

Notice the USR function at line 120. The data in parentheses following 
the address 1536 is placed on the stack for use by the subroutine in this order: 


Top 


STACK 

aa 

bb 

cc 

dd 

ee 


-number of bytes passed 

-high byte of 1 st number 

-<-low byte of 1 st number 

-*-high byte of 2nd number 

-low byte of 2nd number 

where aa, bb, cc, dd, and ee are 
hexadecimal representations 
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The machine language subroutine will pull the top byte off the stack. It is 
not used. The high byte of the 1st number is then pulled off and saved (in mem¬ 
ory $CC). Then the low byte of the 1st number is pulled off and saved (in mem¬ 
ory $CD). You now have this condition: 


Top 


STACK 

dd high byte—2nd number 
ee -<-low byte—2nd number 


MEMORY 

OOCC 

high byte—1st number 

OOCD 

low byte—1st number 


The subroutine then pulls off the high byte of the second number (from 
the stack) and Exclusive ORs it with the high byte of the first number (from 
memory $CC). The result is stored in memory $D5. You now have: 


Top 


STACK 


ee 


low byte-2nd number 


MEMORY 

OOCC 

high byte—1st number 

OOCD 

low byte—1st number 



00D5 

high byte—result 


Next, the subroutine pulls off the low byte of the second number (from 
the stack) and Exclusive ORs it with the low byte of the first number (from 
memory $CD). The result is stored in memory $D4. You now have: 


Top 


STACK 

?? 


all variables 
passed by USR 
are gone 


MEMORY 

OOCC 

high byte—1st number 

OOCD 

low byte—1st number 



00D4 

low byte—result 

00D5 

high byte—result 


Last of all, the RTS (Return from subroutine) instruction is executed. 
The values stored in $D5 and $D4 are passed back to the BASIC program as the 
decimal value for the variable A. 

This is what the machine language subroutine looks like: 




ENTERING THE SUBROUTINE 241 


100 

*=$0600 


110 

EXOR PLA 

-number of data bytes 

120 

PLA 

-get high byte—1st number 

130 

STA $CC 

-•-and store 

140 

PLA j 

_now the low byte 

150 

STA $CD i 


160 

PLA 

-high byte—2nd number 

170 

EOR $CC 

-*-exclusive or 

180 

STA $D5 

and store 

190 

PLA 

| now the low bytes 

200 

EOR $CD 

► -- 

210 

STA $D4 

1 

220 

RTS 

-*-now return S 

230 

END 

A\>* 


ENTERING THE SUBROUTINE 

Now, go through the steps outlined in the 
Assembler User’s Manual. 



1. Place the Assembler Cartridge in the computer and 
enter the assembly language subroutine. 

2. Assemble the program to make sure that you have 
no errors. 

f EDIT 
ASM 


0000 


0100 


*= 

$0600 

0600 

68 

0110 

EXOR 

PLA 


0601 

68 

0120 


PLA 


0602 

85CC 

0130 


STA 

$CC 

0604 

68 

0140 


PLA 


0605 

85CD 

0150 


STA 

$CD 

0607 

68 

0160 


PLA 


0608 

45CC 

0170 


EOR 

$CC 

060A 

85D5 

0180 


STA 

$D5 

060C 

68 

0190 


PLA 


060D 

45CD 

0200 


EOR 

$CD 

060F 

85D4 

0210 


STA 

$D4 

0611 

60 

0220 


RTS 




0230 

END 




EDIT 
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3. Use 3(a) for cassette storage or 3(b) for disk storage and assemble again, 
(a) For cassette: 


EDIT 

ASM„#C: Press RETURN 

After the “BEEP” press RETURN AGAIN 



(b) For disk: 



| ASM„#D:EXOR.OBJ Press RETURN 

4. Take out the Assembler Cartridge and replace it with the BASIC cartridge. 

5. Wait for the BASIC READY prompt. 


I I READY 

6. Use 6(a) for cassette or 6(b) for disk. 

(a) Follow the normal procedure for loading from tape with: 

(CLOAD and press RETURN 


(b) Type in DOS to raise the Disk Operating System. 


C DISK OPERATING SYSTEM 9/24/79 

COPYRIGHT 1979 ATARI 


A. DISK DIRECTORY 

B. RUN CARTRIDGE 

C. COPY FILE 

D. DELETE FILE(S) 

E. RENAME FILE 

F. LOCK FILE 

G. UNLOCK FILE 

H. WRITE DOS FILE 


I. FORMAT DISK 

J. DUPLICATE DISK 

K. BINARY SAVE 

L. BINARY LOAD 

M. RUN AT ADDRESS 

N. DEFINE DEVICE 

O. DUPLICATE FILE 


SELECT ITEM 
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Then type L to load a binary file. 



Now, type: EXOR.OBJ and press RETURN 



After the file is loaded, the computer will return to the SELECT ITEM 
PROMPT. 



Type B and press return to return to BASIC. 



7. You should now be back in the BASIC READY modt 
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8. Enter the BASIC program. 


100 REM ** EOR SUBROUTINE PROGRAM ** 
110 CLS 

120 A = USR(1536,183,30) 

130 PRINT "183 EXCLUSIVE OR WITH 30 IS”;A 
140 END 


You are now ready to execute your program—ALMOST. First check to 
make sure the machine language subroutine is in memory. This can be done by 
checking the first location of the subroutine. Type: 

PRINT PEEK(1536) and press RETURN 

The computer should respond with the value 104 (the decimal equivalent of the 
first machine language instruction, PLA). 

If the computer responds correctly, execute the program with the RUN 
command. If it doesn’t correspond correctly, go back to the Assembler Cartridge 
and try it all again. Verrrrry carefully. 



.The decimal equivalent 
of the EOR result. 


128+32+8+1 or 


10101001 in binary 

You may use the Exclusive OR with other values by changing line 120 of 
the BASIC program. 


120 A = USR(1536,183,30) 


= These values may change. 


Do not change the value 1536 as that is the memory location where the sub¬ 
routine begins. The other two values (183 and 30) may be changed to any posi¬ 
tive integer in the range of 0 through 65535. 

The remaining programs in this chapter will show only the versions of the 
programs that may be run directly in the Debugger mode of the assembler. Feel 
free to change them to subroutines to be accessed from BASIC as in the EOR 
program. 
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PROGRAM TO SOUND OFF 

This program uses three sound registers (or channels) for playing music 
chords. The data is placed in the appropriate registers, and the sound produced 
is sent to your TV set. Be sure that you have the volume of your TV set turned 
to a reasonable level before running the program. The program controls the vol¬ 
ume produced, but the TV volume control must be set high enough to make an 
audible sound. 

The last chord produced will keep playing until a new note is placed in the 
sound registers. Therefore, the last part of the program sets the volume down to 
zero. There are other ways to accomplish the same result, but why not let the 
computer do it for you? 

We have used comments in the source program that label each part of the 
program and the data values used. It is good programming practice to do so. If 
you save the source program on tape or disk, the comments will help you deci¬ 
pher the program when you enter it again. The flow of the program is shown in 
Figure 12-2. 



Figure 12-2. Sound Off Program Flow 


SOUND OFF SOURCE PROGRAM 


100 

110 

120 

130 

140 

150 

160 

170 

180 

190 


*=$0600 

;FIRST CHORD SECTION 
LDA #$79 FI 

STA $D200 


LDA #$88 
STA $D202 
LDA #$99 
STA $D204 
LDA #$AF 
STA $D201 


SECOND NOTE 


TONE AND VOLUME 
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200 STA $D203 

210 STA $D205 

220 JSR DELAY PLAY AWHILE 

230 jSECOND CHORD SECTION 
240 LDA #$C1 FIRST NOTE 

250 STA $D200 

260 LDA #$D9 SECOND NOTE 

270 STA $D202 

280 LDA #$F3 THIRD NOTE 

290 STA $D204 

300 LDA #$A8 TONE AND VOLUME 

310 STA $D201 
320 STA $D203 
330 STA $D205 

340 JSR DELAY PLAY AWHILE 

350 ;TURN VOLUME OFF SECTION 

360 LDA #$A0 

370 STA $D201 

380 STA $D203 

390 STA $D205 

400 BRK END OF MAIN PROGRAM 

410 DELAY LDX#$FF 

420 LOOP LDY #$FF 

430 LOOP1 DEY 

440 BNE LOOP1 

450 DEX 

460 BNE LOOP 

470 RTS 

480 END END OF SOURCE PROGRAM 

Enter the program, assemble it, and execute it in the usual way. See if you 
like the sounds produced. If not, take a look at the table of music notes in Fig¬ 
ure 12-3. You may alter frequency values in the program as long as you stay in 
the range of 0 (highest note) to FF hexadecimal (lowest note). 

To understand the tone and volume controls, you must look at the volume 
in binary form. 

Example: 

195 decimal = AF hexadecimal 
= 1010 1111 
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Natural 

Frequency 

Scale Note 

Value (hex) 

C 

ID High 

B 

IF 

A# 

21 

A 

23 

G# 

25 

G 

28 

F# 

2A 

F 

2D 

E 

2F 

D# 

32 

D 

35 

c# 

39 

c 

3C 

B 

40 

A# 

44 

A 

48 

G# 

4C 

G 

51 

F# 

55 

F 

5B 

E 

60 

D# 

66 

D 

6C 

c# 

72 

c 

79 Middle 

B 

80 

A# 

88 

A 

90 

G# 

99 

G 

A2 

F# 

AC 

F 

B6 

E 

Cl 

D# 

CC 

D 

D9 

c# 

E6 

c 

F3 Low 

Figure 72-3. 

Approximate Values for Three-Octave Scale 
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The first hex digit (A in example) controls the noise content of the tone. 
We chose a pure tone. The second hex digit controls the volume. Its range may 
be from 0 (lowest volume = off) to F (highest volume). 

You should try different values to obtain different sound effects. All you 
need to do is change the values for frequency, tone and volume. Check the com¬ 
ments in the source program to find the values to be changed. 

1. Changes may be made in the source program. 

(a) In the Edit mode change lines: 

120,140,160, 180 for the first chord 
240, 260, 280, and 300 for second chord 

(b) Assemble the program again. 

(c) Execute it from the Debugger mode. 

2. Changes may be made in the object program. 

Use the Debugger mode to change memories: 

0601, 0606, 060B and 0610 for first chord 
061E, 0623, 0628 and 062D for second chord 


PLAY NOTES PROGRAM 


This program uses a single sound channel to play a series of notes. A time 
delay is used between the notes so that they can be heard for a reasonable length 
of time. Once again, make sure that the volume on the TV set is turned up. By 
looking at the frequency table of Figure 12-3, you can see that the program 
plays one octave of the scale. 

ASSEMBLER PROGRAM 


100 

*=$0600 



110 

;PLAY NOTES 


120 

LDA 

#$AF 

-*-Volume 

130 

STA 

$D201 


140 

LDA 

#$F3 

“*-Freq. 1st note 

150 

JSR 

RPT 


160 

LDA 

#$D9 

•*-Freq. 2nd note 

170 

JSR 

RPT 


180 

LDA 

#$C1 

•*-Freq. 3rd note 

190 

JSR 

RPT 


200 

LDA 

#$B6 

etc. 

210 

JSR 

RPT 

1 

220 

LDA 

#$A2 


230 

JSR 

RPT 

1 



PROGRA M TO SHA PE SOUND 249 


240 

LDA 

#$90 

250 

JSR 

RPT 

260 

LDA 

#$80 

270 

JSR 

RPT 

280 

LDA 

#$79 

290 

JSR 

RPT 

300 

LDA 

#$A0 

310 

STA 

$D201 

320 

BRK 


330 

RPT STA 

$D200 

340 

LDX 

#$ FF 

350 

JSR 

DELAY 

360 

RTS 


370 

DELAY 

LDY #$FF' 

380 

LOOP DEY 1 

390 

BNE 

LOOP ' 

400 

DEX 

I 

410 

BNE 

DELAY 

420 

RTS 


430 

END 



TURN VOLUME OFF 
--END OF PROGRAM 

-Back to main subroutine 

■*-Play the note awhile 

-Back to RPT subroutine 


Enter the program and assemble and execute it. Does it sound reasonable 
to you?lf not, changes can be made where the frequencies are loaded into the 
accumulator. The duration of the notes can be changed by the LDY and LDX 
instructions in the RPT subroutine. 

This program could be changed so that it would access the frequencies 
from a data table. The frequencies could then be accessed by an indexed load 
instruction. This might be a little difficult since the X and Y registers are already 
being used in the time delay subroutine. You would have to save their values on 
the stack, and retrieve them after the time delay had been completed. We have 
covered the use of the stack instructions before. Therefore, you know how to 
make these changes if you wish. 

Notice in line 300 and 310 that the value AO was stored in memory lo¬ 
cation D201. This sets the volume to zero. If those two lines were omitted, the 
last note would keep playing even though the program had ended. 


PROGRAM TO SHAPE SOUND 

This program uses one sound channel to shape the sound that is produced. 
If you look at a graph of the volume of the sound produced over a period of 
time, it would look something like this: 
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Attack Peak Decay 




You can see that the sound goes through three distinct periods. You have 
used the frequency, tone and volume variables before. Now, you have a chance 
actually to vary the shape of the sound produced. 

We have chosen one of the three time constants-the decay time. It will be 
changed as the program is executed. It is varied from 50 to 200 (decimal) within 
a loop in steps of 25 (50, 75, 100, 125, 150, 175 and 200). The sound is thus 
shaped as follows: 



etc. 


SOUND SHAPER PROGRAM 
100 *=$0600 


110 

INITIALIZE TIMES 

120 

LDA 

me 

FREQUENCY 

130 

STA 

$D200 


140 

LDA 

#$32 

PEAK 

150 

STA 

$CD 


160 

LDA 

#$0A 

ATTACK 

170 

STA 

$cc 


180 

LOOP 

LDA $1000 COUNTER 

190 

TAX 



200 

LDA 

$1000,X 


210 

STA 

$CE 

DECAY 

220 

DEC 

$1000 


230 

LDA 

#$A0 

VOLUME 

240 

ATTK 

STA $D201 

250 

LDX 

$CC 


260 

JSR 

DELAY 


270 

CLC 





PROGRAM TO SHAPE SOUND 251 


280 ADC #$01 
290 CMP #$80 
300 BNE ATTK 
310 LDA #$0E 
320 PEAK LDX $CD 
330 JSR DELAY 
340 SEC 
350 SBC #$01 
360 BNE PEAK 

370 LDA #$AF TONE,VOLUME 

380 DCAY STA $D201 

390 LDX $CE 

400 JSR DELAY 

410 SEC 

420 SBC #$01 

430 CMP #$9F 

440 BNE DCAY 

450 LDA $1000 

460 BNE LOOP 

470 BRK 

480 DELAY LDY #$13 
490 ROUND DEY 
500 BNE ROUND 
510 DEX 
520 BNE DELAY 
530 RTS 
540 END 


This may be your longest program yet. Enter and assemble it. Check the 
highest memory location used. Remember, we must stay between 0600 and 
06FF or we will run into some memory that we shouldn’t be using. 


0655 60 0530 



RTS 


Last location 


looks OK 


DEBUG 


So go on to DEBUG mode 



252 PROGRA MMING PRA CTICE 


Before you execute the program, remember that you may not have entered 
the data to be used as the counter and the decay times. Refer to the table below, 
and enter the data in the Debugger mode. 


Address | 

Data 

1000 

07 

1001 

C8 

1002 

AF 

1003 

96 

1004 

7D 

1005 

64 

1006 

4B 

1007 

32 


-*-7 notes to be played 


-«-the decay times 


Figure 12-4. Data for Sound Shaper Program 


Now execute the program. You should be able to detect the differences in decay 
time. 

You might want to experiment with the other parameters (attack time, 
peak time, frequency or volume). Feel free to modify our program to suit your 
own purposes. 


PROGRAM TO PRINT ON THE SCREEN 


Hidden away in your Atari’s memory are lots of nice little subroutines that 
might save you much time and effort. We found one hidden away at memory lo¬ 
cation $F6A4. It will display on the screen the character whose ATASCII code is 
in the accumulator. 


Example: 


jump to 
subroutine 


LDA #$41 


JSR$F6A4 



AT ASCI I code for 
the letter A 

location of display 
subroutine 


The instructions above would display the letter A, and then the 
cursor would move one place to the right, ready to display what¬ 
ever comes next. 

You must be careful when you use this subroutine if you are using the X and Y 
register in your program. Your values (in X and Y) will be destroyed by the sub¬ 
routine as it also uses these registers. Therefore, you must make provision to save 
them (the stack is the ideal place for this). 

The program that we will use is short, but you will have to load in lots of 
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data in a data table. The X register and the Absolute Indexed Addressing mode 
will be used to load the accumulator with the ATASCII codes from the data 
table. The ATASCII Character Set is given in Appendix F. 

PRINT ON THE SCREEN 


100 

*=$0600 


110 

; PRINT ON THE SCREEN 

120 

LDX 

#$2B 

NUMBER OF CHARACTERS 

130 

LOOP 

TXA 


140 

PHA 


SAVE NUMBER 

150 

LDA 

$1100,X 

LOAD CODE 

160 

JSR 

$F6A4 

DISPLAY CHARACTER 

170 

PLA 


GET NUMBER BACK 

180 

TAX 



190 

DEX 


COUNT DOWN 

200 

BNE 

LOOP 

GO BACK IF NOT DONE 

210 

LOO PI 

JMP LOOP1 CIRCLE HERE 

220 

END 




Enter and assemble the program. Now comes the chore of loading the 
data, Go into the Debugger mode and enter the data as shown. 


EDIT 

BUG 

DEBUG 

C1101<9B,9B,9B,6,E,7,9B 

DEBUG 

Cl 108<2,0,16,96,7,0,6,98 
DEBUG 

Cl 11 (X0,0,0,9B,44,4E,45,20 


DEBUG 

Cl 128<20,75,6F,59 


Press RETURN 
at end of each line 



DEBUG 

Cl 118<65,68,74,9B,64,65,68,63 
DEBUG 

Cl 121X61,65,72,9B,65,76,61,68 


DEBUG 
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We’re not going to spoil the purpose by telling you what all those numbers 
represent yet. If you can’t wait, Figure 12-5 shows what character is represented 
by each code. 

Before you run the program, clear the screen by holding down the | SHIFT | 


key and pressing the 


key. 


Screen is cleared 


Now, execute the program by typing: 

|G0600 and press RETURN 

This is what you see: 

r G0600 
You have 
reached 
the END 

tfV 

0 


The last lines of the program keep the display on the screen while the com¬ 
puter goes around and around doing nothing. Press the BREAK key to stop the 
program. 

Flere are the ATASCI I codes used in the program. 


Memory 

Address 

Hex A TASCII 

Code 

Character 

Displayed 

112B 

59 

Y 

112A 

6F 

0 

1129 

75 

u 

1128 

20 

SPACE 

1127 

68 

h 

1126 

61 

a 

1125 

76 

v 
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65 

e 


9B 

CARRIAGE RETURN 


72 

r 


65 

e 


61 

a 


63 

c 


68 

h 


65 

e 


64 

d 


9B 

CARRIAGE RETURN 


74 

t 


68 

h 


65 

e 


20 

SPACE 


45 

E 


4E 

N 


44 

D 


9B 

CARRIAGE RETURN 


00 

o 


00 

c? 


00 

O 


9B 

CARRIAGE RETURN 


06 

& 


0D 

CD 


07 



9B 

CARRIAGE RETURN 


16 

D 


00 



02 

0 


9B 

CARRIAGE RETURN 


07 



OE 

CD 


06 

<7 


9B 

CARRIAGE RETURN 


9B 

CARRIAGE RETURN 


9B 

CARRIAGE RETURN 

Figure 12-5. A TASCII Codes for Print on the Screen 
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Now, you can create your own graphics and messages by replacing our 
codes with any that you choose from Appendix F. You can lengthen or shorten 
the data table, but be sure you put the corresponding number in line 120 of the 
source program. Fill the screen and have fun!! 

YOU’RE ON YOUR OWN 

We are going to leave you at this point. You now have a fundamental 
knowledge of how the Assembler Cartridge works. You also have a background 
in the 6502 instruction set. With the understanding you now have, you can ex¬ 
plore other assembly language features. These can be found in your Atari Assem¬ 
bler User’s Manual. You should also explore the operation of all instructions in 
the 6502 set. The more that you work with assembly language programming, the 
more you will probably like it. 

If you intend to do a sizable amount of assembly language programming, 
we recommend the use of the Atari 810 or 815 Disk Drive along with the Atari. 
820 or 822 or 825 Printer. We have used the 810 Disk Drive along with the Atari 
820 printer and find them both very convenient for assembly language pro¬ 
gramming. 

Good Programming! 
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6502 Instructions- 
Flags Affected 


X in the box means the flag is affected. The result will depend upon the 
condition, or status, resulting from a previous operation. A one (1) indicates that 
the flag is set, a zero (0) that a flag is reset. 


Mnemonic 

Code 

Operation Performed 

Status Fiat 

* 

N 



B 

D 

/ 

z 

c 

ADC 

Add memory to accumulator with carry 

X 

X 





X 

X 

AND 

AND memory with accumulator 

X 






X 


ASL 

Shift left one bit (memory or accum.) 

X 






X 

X 

BCC 

Branch on carry clear (If C=0) 









BCS 

Branch on carry set (If C=1) 









BEQ 

Branch on result zero (If Z=1) 









BIT 

Test bits in accumulator with memory 

X 

X 





X 


BMI 

Branch on result minus (If N=1) 









BNE 

Branch on result not zero (If Z=0) 









BPL 

Branch on result plus (If N=0) 









BRK 

Force break 






1 



BVC 

Branch on overflow clear (If V=0) 









BVS 

Branch on overflow set (If V=1) 









CLC 

Clear carry flag 








0 

CLD 

Clear decimal mode 





_0 




CLI 

Clear interrupt disable flag 






0 



CLV 

Clear overflow flag 


0 







CMP 

Compare memory and accumulator 

X 






X 

X 

CPX 

Compare memory and index X 

X 






X 

X 

CPY 

Compare memory and index Y 

X 






X 

X 

DEC 

Decrement memory by one 







X 

X 

DEX 

Decrement index X by one 







X 

X 

DEY 

Decrement index Y by one 







X 

X 

EOR 

Exclusive OR memory with accumulator 







X 

X 
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Mnemonic 

Code 

Operation Performed 

Status Flags 

N 



B 

0 

' 

z 

c 

INC 

Increment memory by one 







X 

X 

INX 

Increment index X by one 







X 

X 

INY 

Increment index Y by one 







X 

X 

JMP 

Jump to new location 









JSR 

Jump to new location save rtn. add. 









LDA 

Load accumulator from memory 







X 

X 

LDX 

Load index X from memory 







X 

X 

LDY 

Load index Y from memory 







X 

X 

LSR 

Shift right one bit (memory or accum.) 

0 






X 

X 

NOP 

No operation 









ORA 

OR memory with accumulator 

X 






X 


PHA 

Push accumulator on stack 









PHP 

Push processor status on stack 









PLA 

Pull accumulator from stack 







X 

X 

PLP 

Pull processor status from stack 

X 

X 

X 

X 

X 

X 

X 

X 

ROL 

Rotate one bit left (mem. or accum.) 

X 






X 

X 

ROR 

Rotate one bit right (mem. or accum.) 

X 






X 

X 

RTI 

Return from interrupt 

X 

X 

X 

X 

X 

X 

X 

X 

RTS 

Return from subroutine 









SBC 

Subtract memory and borrow from accum. 

X 

X 





X 

X 

SEC 

Set carry flag 








1 

SED 

Set decimal mode 





T 




SEI 

Set interrupt disable flag 






1 



STA 

Store accumulator in memory 









STX 

Store index X in memory 









STY 

Store index Y in memory 









TAX 

Transfer accumulator to index X 

X 






X 


TAY 

Transfer accumulator to index Y 

~x 






IT 


TSX 

Transfer stack pointer to index X 

X 






X 


TXA 

Transfer index X to accumulator 

X 






X 


TXS 

Transfer index X to stack pointer 









TYA 

Transfer index Y to accumulator 

X 






X 



Flag abbreviations are: 

N Negative result flag 
V Overflow flag 

Expansion flag (not labeled) 
B Break command flag 


D Decimal mode flag 
I Interrupt disable flag 
Z Zero result flag 
C Carry flag 
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6502 Instructions- 
Addressing Modes 
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Appendix C 


Frequency Values 
for Three-Octave Scale 


Natural Frequency 

Scale Note Value 


C 

B 

A# 

A 

G# 

G 

F# 

F 

E 

D# 

D 

C# 

c 

B 

A# 

A 

G# 

G 

F# 

F 

E 

D# 

D 

C# 

c 

B 

A# 

A 

G# 


ID High 

IF 
21 
23 
25 
28 
2A 
2D 
2F 
32 
35 

39 
3C 

40 
44 
48 
4C 
51 
55 
5B 
60 
66 
6C 
72 

79 Middle 

80 
88 
90 
99 


26/ 
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Natural Frequency 

Scale Note Value 


G 

F# 

F 

E 

D# 

D 

C# 

c 


A2 

AC 

B6 

Cl 

CC 

D9 

E6 

F3 


Low 
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Atari Assembler Error Codes 


When an error occurs, a short “beep” is heard and the error number is 
displayed. 

Error Number Explanation 

1 Insufficient memory for the program to be assembled. 

2 The number xx cannot be found for the “DEL xx,yy” 

command. 

3 An error in specifying an address (mini-assembler). 

4 File named cannot be loaded. 

5 Undefined reference label. 

6 Syntax error in a statement. 

7 Label defined more than once. 

8 Buffer overflow. 

9 No label given before “=”. 

10 The value of an expression is greater than 255 where one 

byte was required. 

11 Null string used where invalid. 

12 Address or address type specified is incorrect. 

13 Phase error-an inconsistent result found from Pass 1 to 

Pass 2. 

14 Undefined forward reference. 

15 Line is too large. 

16 Source statement not recognized by the assembler. 

17 Line number too large. 

18 LOMEM command was attempted after other command(s) 

or instruction(s). LOMEM must be first command if used. 

19 No starting address given. 
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Atari Operating System Errors 


Errors numbered above 100 refer to Operating System and Disk Operating 
System. Refer to DOS manual for complete list of DOS errors. 


Error Number Explanation 

128 The BREAK key was hit during an I/O operation. 

130 A nonexistent device was specified. 

132 Command is invalid for the device selected. 

136 END OF FILE READ HAS BEEN REACHED. This error 

may occur when reading from cassette. 

137 Record was longer than 256 characters. 

138 Device specified in the command does not respond. Make 

sure it is connected and powered. 

139 Device specified in command does not return an acknowl¬ 

edge signal. 

140 Serial framing error. 

142 Serial fram ing error. 

143 Serial data checksum error. 

144 Device done error. 

145 Diskette error- read-after-write comparison failed. 

146 

162 Disk full. 

165 File name error. 
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ATASCII Character Set 


ATASCII is an abbreviation of ATARI ASCII. Letters and numbers have 
the same values as those in ASCII, but some of the special characters have been 
assigned differently. Characters 80-FF (hex) are just reverse colors of 1-7F ex¬ 
cept for the characters shown (9B-9F and FD, FE, and FF). 
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A TASCII CHA RACTER SET 




HEX 

CHARACTER HEX 

CHARACTER 

HEX 

CHARACTER 

IE 

Q 

2 

46 

F 

IF 

Q 

3 

47 

G 

20 

Space 34 

4 

48 

H 

21 

! 35 

5 

49 

1 

22 

” 36 

6 

4A 

J 

23 

# 37 

7 

4B 

K 

24 

$ 38 

8 

4C 

L 

25 

% 39 

9 

4D 

M 

26 

& 3A 


4E 

N 

27 

‘ 3B 

; 

4F 

0 

28 

( 3C 

< 

50 

P 

29 

) 3D 

= 

51 

Q 

2A 

* 3E 

> 

52 

R 

2B 

+ 3F 

? 

53 

S 

2C 

, 40 

9 

54 

T 

2D 

41 

A 

55 

U 

2E 

42 

B 

56 

V 

2F 

/ 43 

C 

57 

w 

30 

0 44 

D 

58 

X 

31 

1 45 

E 

59 

Y 
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CHARACTER 


k 


o 

P 

q 


y 


HEX CHARACTER 
7A 
7B 
1C 
7D 
7E 
7F 


9D 

9E 


9F 

FD 

FE 

FF 


OBQDC3 J 




Index 


A 

Absolute addressing mode, 90 
Absolute indexed addressing mode, 
146 

Accumulator, 5, 74 
Addition, 164 
Addressing modes, 88 
Architecture, 4 
Arithmetic Shift Left, 191 
Assembler cartridge, 1, 53 
Assembler program (of the cartridge), 
53,57, 120 

Assembly language, advantages, 3 
ATASCII character codes, 252, 265 

B 

BASIC cartridge, 1 
BASIC, review, 7 

Binary-coded-decimal (BCD) numbers, 
179 

Binary-hexadecimal relationship, 14 
Binary numbers, 12 
Bits, 13 

Branch backward, 97,101 
Branch forward, 96,100 
Branch instructions, 102 
Bytes, 13 


C 

Carry flag, 102 
Cartridge (assembler), 1 
Cartridge (BASIC), 1 
Central Processing Unit (CPU), 4 

D 

Data bus, 5 

DEBUGGER program (of the 
cartridge), 53, 62,131 
Decimal arithmetic, 179 
Disassemble, 135 
Division, 221 

E 

EDIT mode (same as WRITER/ 
EDITOR), 124 
Edit text buffer, 125 
Error codes, 121,263, 264 
Exclusive OR, 237 

F 

Fields used in assembler statements, 
120 
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Flags (status), 7, 82 

Format (assembly language), 55, 120 


H 

Hexadecimal-decimal relationship, 16 
Hexadecimal notation, 14 


I 

Immediate addressing mode, 89 
Implied addressing mode, 88 
Instruction set (6502), 91, 257, 259 


L 

Label (assembler statement), 120 
Least Significant Byte, 37 
Logical Shift Right, 198 


M 

Machine Language, disadvantages, 2 
Memory map, 28 
Mnemonic codes, 60, 121 
Most Significant Byte, 37 
Multiplication, 214 


N 

Negative flag, 111 
Negative numbers, 174 


O 


P 

Passing data: BASIC to machine 
language, 33 

POKE machine language from BASIC, 
19 

Processor Status Register, 7, 82 
Program counter, 6, 96, 227 
Program design, 144 


R 

Registers, 5, 73 
Relative addressing mode, 90 
Rotate Left, 202 
Rotate Right, 205 


S 

Signed numbers, 113 
6502 instruction set, 91, 257, 259 
Sound programs, 245, 248, 249 
Source program, 55, 59,120 
Stack, 6, 22, 87, 226 
Stack Pointer, 6, 87 
Status flags affected by instructions, 7, 
85, 257 

Subroutines, 225 

Subroutine to display on the screen, 
252 

Subtraction, 172 


T 

Trace (of a program), 45, 63 


Object program, 56, 59 U 

Operand, 121 

Overflow flag, 116 USR function, 31 
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W 

WRITER/EDITOR program (of 
cartridge), 52, 53, 124 

X 

X Register, 74 


Y 

Y Register, 74 

Z 

Zero flag, 108 

Zero page addressing mode, 90 
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